Это должно быть намного проще ...
Я хочу добавить «кодированный» разрыв строки в документацию XML в моем коде
/// <summary>
/// Get a human-readable variant of the SQL WHERE statement of the search element. <br/>
/// Rather than return SQL, this method returns a string with icon-tokens, which
/// could be used to represent the search in a condensed pictogram format.
/// </summary>
Как видите, я нашел несколько ответов, которые продемонстрировали добавление скобок <и>. Интересно отметить, что хороший разрыв строки не создает разрыв строки во всплывающем окне Intellisense.
Я нахожу это раздражающим ...
Какие-либо предложения?
c#
.net
xml-documentation
Tinkerer_CardTracker
источник
источник
Ответы:
Вы можете использовать
<para />
тег для создания разрыва абзаца или вы можете заключить текст в<para></para>
теги как способ сгруппировать текст и добавить пустую строку после него, но не существует эквивалента<br />
или чего-либо подобного. (Который в соответствии с этим старым сообщением форума MS предназначен для этого .) Вы можете получить список доступных тегов в этой статье документации от MS. Документирование вашего кодаПример (на основе оригинального образца OP):
источник
<para>
теги игнорируются, и в Intellisense все смешивается в одну строку. Нашел этот вопрос, где Ганс объяснил проблему: stackoverflow.com/questions/7070737/… .Это мое использование, вроде
<br/>
, это работает :)источник
<para> </para>
,<para> </para>
или невидимый характер ...<para/>
кажется, добавляют пустую строку, а не просто разрыв строки.Начиная с Visual Studio 2019, используйте
<br/>
для новых строк в комментариях.Пример:
Обратите внимание, что при использовании
<br/>
вместо<para>
. Дополнительная строка не добавляется .источник
Добавьте
<para>
тег со специальным символом, 255 символом или невидимым символом .Это будет работать так:
источник
не работает, вместо этого используйте/// <para> </para>
/// <para> </para>
в записке. Тогда это просто скопировать и вставить! (И это работает - по крайней мере, для меня)/// <para> </para>
не работает вообще./// <para> </para>
работает!<para>
тег между блоками текста, вы должны использовать<para>
тег вокруг всех абзацев, кроме первого в<summary>
элементе. Для<typeparam>
,<param>
,<value>
,<exception>
и<returns>
элементов, использовать их по всем пунктам , если у вас есть более одного ( по желанию , если у вас есть только один для этих элементов). Для всех других элементов блока (в том числе<note>
внутри другого элемента блока) используйте<para>
теги вокруг всех абзацев, даже если у вас есть только один.<br></br>
и<br />
кажется, что это не работает, и иногда дело не в том, чтобы<para>
разделить предложения так сильно, как в желании иметь пустую строку для разделения проблем. Я упоминаю об этом здесь, потому что этот вопрос, кажется, является родителем для многих закрытых вопросов такого рода.Единственное, что я нашел на работе, было
Например
Результаты в
источник