Показать xml-тег ‹returns› в Visual Studio intellisense

Я добавил тег <returns> xml в некоторые из своих методов, но не вижу его содержимого в IntelliSense.

Вот мой код:

/// <summary>
/// we all live in a yellow summary
/// </summary>
/// <returns>what it returns</returns>
public int MyMethod()
{ .... }

Есть ли способ показать этот контент?


visual-studio intellisense documentation roslyn xml-documentation
person remi bourgarel    schedule 17.03.2010    source источник
comment
Связано: stackoverflow.com/questions/7818694/   -  person Otiel    schedule 25.01.2013
comment
На самом деле его вопрос связан с моим. Но на него есть ответ   -  person remi bourgarel    schedule 25.01.2013
comment
Проголосуйте за него здесь. Если будет достаточный спрос, мы можем его получить.   -  person Sam    schedule 05.09.2013
comment
Мне всегда было интересно, в чем смысл тега возврата. Я имею в виду, что я обычно добавляю некоторые основные детали, но я никогда не видел в этом смысла.   -  person Jamie Taylor    schedule 23.09.2013
comment
Он используется в MSDN как автоматизированная документация, основанная на ваших XML-комментариях. Примерно так: msdn.microsoft.com/en -us/library/e78f86at(v=vs.110).aspx   -  person user5328504    schedule 12.04.2017
comment
Возможный дубликат подсказки Intellisense и XML возвращает комментарий (VS2008)   -  person HaveSpacesuit    schedule 10.05.2017

Ответы (3)


arrow_upward
4
arrow_downward

Наконец-то это было реализовано в Visual Studio 2019 v.16.6.0, всего десять лет спустя :)

Из примечаний к выпуску: Возвращает содержимое тега

person A. Milto    schedule 08.09.2020
comment
К сожалению, он будет отображаться только при наведении курсора на имя метода. Он не отображается при просмотре перегрузок или при вводе параметров. - person Rev; 04.12.2020

arrow_upward
3
arrow_downward

В настоящее время это не работает (Visual Studio 2017) и является открытой проблемой:

https://github.com/dotnet/roslyn/issues/31618

Один из способов заставить его работать — установить плагин ReSharper Visual Studio (но это платно).

person Hermann.Gruber    schedule 30.01.2019

arrow_upward
-2
arrow_downward

Иногда IntelliSense требуется время, чтобы понять ваш код. Чтобы убедиться, что тег присутствует, попробуйте использовать параметр компилятора /doc следующим образом:

csc ВашКласс.cs /doc:ВашКласс.xml

Если тег присутствует, то это просто проблема IntelliSense, которая обычно устраняется самостоятельно или перезапуском VS.

person graumanoz    schedule 17.05.2017
comment
Этот ответ неверен. Начиная с Visual Studio 2017, IntelliSense никогда не отображает тег «return». - person Arturo Torres Sánchez; 02.02.2019