XML-комментарии <list> не отображаются в IntelliSense

Я пытаюсь заставить XML-комментарии VB.NET работать с IntelliSense, и, возможно, это не работает так, как я думаю он делает.

    ''' <summary>
    ''' Gets or sets the Patient Code.
    ''' <list type="bullet">
    ''' <listheader><description>Validation:</description></listheader>
    ''' <item><description>Field Required</description></item>
    ''' <item><description>Field Max Length: 25</description></item>
    ''' </list>
    ''' </summary>
    ''' <value>The region reference key.</value>

Это означает, что при вводе функции отобразите "Получить или установить код пациента" ниже, чтобы он отображал список маркированных элементов с "Validation:" в качестве заголовка?

alt text http://www.codejames.com/errored.jpg

Возможно, я делаю это неправильно, но, похоже, он работает неправильно.

Ответы

Ответ 1

Вы не делаете это неправильно, это просто не поддерживается. Хотя HTML-надписи могут появляться на выходе некоторых инструментов, IntelliSense не является одним из них.

IntelliSense - это текстовый дисплей в Visual Studio 2008, и мы не поддерживаем отображение многих/большинства надстроек, поскольку они должны отображаться в стиле HTML. Вместо этого мы склонны выделять теги разметки, которые не поддерживаются, и отображать полученный текст.

Ответ 2

Вы можете "подделать" его (без цифр), окружив содержимое <description> тегом <para> - это будет по крайней мере отображаться в Intellisense красиво разнесенным, но без соответствующего разделителя списка (bullet, number).

<summary>
Gets or sets the Patient Code.
<list type="bullet">
<listheader><description>Validation:</description></listheader>
<item><description>Field Required</description></item>
<item><description>Field Max Length: 25</description></item>
</list>
</summary>
<value>The region reference key.</value>

<ы > Если вам не все так сильно связано с генерируемым выходом, просто добавьте свою пулю в каждую строку:

<item><description><para>* Field Required</para></description></item>

См. также <list> Документация XML

Update

После публикации этого вопроса, VS2012 11.0.60610.01 Обновление 3, похоже, добавило поддержку форматирования, поэтому вам больше не нужна внутренняя упаковка <para> или добавление собственных патронов.