Как показать содержимое внутри см. Cref в XML-комментарии от Intellisense и DocFx? - PullRequest
2 голосов
/ 02 июля 2019

Я использовал XML-комментарий к свойству, которое относится к типу List.

Однако, когда я наведу указатель мыши на это свойство, Visual Studio показывает его как List<T>.

КогдаЯ создаю документацию с помощью docFx, он по-прежнему отображает комментарий как List<T> вместо List<ClassXXXX>.

Я пробовал решение, рекомендованное предыдущим постом , но оно не работает.

Вот XML-комментарий с кодом C # для вашей справки:

/// <summary>
/// Gets and sets the <see cref="List{T}"/> .
/// </summary>
public List<ClassXXXX> ListFoo { get; set; }

Что я могу сделать в XML-комментарии, чтобы видеть List<ClassXXXX> в intellisense и документации?

Спасибо

1 Ответ

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

Установите текст, который вы хотите явно, в теге :

/// Gets and sets the <see cref="List{T}">List&lt;ClassXXXX&gt;</see> .

Вы не можете указать List непосредственно в атрибуте cref.Cref - это ссылка на определение типа и его документацию.Там нет типа List и нет документации для него.Там есть только список , на который вы можете создать ссылку.Но текст ссылки может быть чем угодно.

...