只有某些xmldoc标记与IntelliSense相关

时间:2017-09-18 17:06:01

标签: c# comments intellisense xml-documentation

Microsoft有all sorts of documented xml tags用于文档评论(以三斜杠开头),但其中一些(例如<list>)实际上并未改变工具提示文本的格式,IntelliSense给了我,而只是它被扔进一个混乱的堆: enter image description here

这些是产生该工具提示的文档注释:

/// <summary>
/// <code>None of this gets formatted</code>
/// Test list:
/// <list type="number"><listheader><term>testT</term><description>testD</description></listheader>
/// <item><term>This gets</term><description>crammed</description></item></list> 
/// See <see cref="unixEpoch"/>
/// </summary>
/// <param name="date"></param>
/// <param name="TimeZoneOption"></param>
/// <returns>Things that have <code>code</code></returns>

所以我的问题是:

  1. 似乎是因为智能感知目的而忽略了任何未加星标in the MS doc的内容,但如果内部的文字没有进入,为什么甚至会有一个<code>标记看起来有什么不同?
  2. 为什么<returns>部分根本没有显示在工具提示中?
  3. 有没有办法强制我缺少换行?

0 个答案:

没有答案