Могу ли я использовать <see cref> вне объявления метода - PullRequest
Новая
       28

Могу ли я использовать <see cref> вне объявления метода

0 голосов
/ 02 июля 2018

Мне нужно использовать ///<see cref=""> в комментарии, который находится внутри функции, и я могу заставить его работать только в объявлении метода.

Возможно ли то, что я пытаюсь достичь? Если да, то как?

Так что по сути мне нужно это: 

///<summary>
///this is a summary where i can use the <see cref=""> with ease
///</summary>
internal virtual void OnClick()
{
    if (player.IsPlaying || player.IsBuffering)
    {
        //Some lengthly comment about code that I erased for simplicity
        //And I would like to add a <see cref=""> somewhere around here.
        player.Stop(false);
    }

        item.TogglePlayStop();
    }
}

Если я помещу это в метод, я получу XML Comment is not placed on a valid language element. Снаружи отлично работает.

Я бы хотел сделать это, потому что то, что я объясняю в комментарии, не имеет отношения к методу, имеет отношение только к небольшой части кода. Я работаю над устаревшим кодом и должен был добавить что-то вонючее. Я не хочу, чтобы люди удаляли его по ошибке, и я, конечно же, не хочу, чтобы люди тратили на это время. Это просто, когда вы видите всю картинку, и я просто хотел добавить ссылку, чтобы людям не нужно было копировать, вставлять имя класса для навигации, они могут просто нажать на мой комментарий (длиной 7 строк)

...