答案 0 :(得分:31)
答案 1 :(得分:2)
答案 2 :(得分:1)
答案 3 :(得分:0)
经过这么长时间,我感到惊讶的是,没人回答答案中最重要的部分。
Microsoft的标准文档系统由带有///或'''或---等标记的特殊注释(取决于语言)推动。
默认情况下,系统仅提供智能感知功能。可以在编译过程中根据这些特殊注释以及其中的任何受支持标签创建的XML输出可用作其他系统(例如SandCastle和DocFX)的输入,但是您必须安装这些工具并对其进行配置以从中受益。如果使用此类工具,则两个标记之间的差异取决于该工具以及可能如何配置它,而不是由Microsoft确定。因此,请阅读该工具的文档,以了解是否对标签进行了不同的处理,如果使用了不同的处理方式,则采用了这种方式。
话虽如此,如果您不使用外部工具,则可能看不到使用任何一个标签的意义,因为没有明显的理由这样做,并且如果您选择使用一个或另一个,则两者之间也没有明显的区别。 。
事实是,从智能感知的角度来看,目前它们之间没有区别。但是,即使您不使用读取XML输出的工具,也有很好的理由使用它们之一。原因是重新加工!
通过标记标识符(使用see或seesee),而不是仅将其名称键入为文字文本,Visual Studio的重构工具将被告知该标签是合法标识符。这导致标识符的任何重命名都包括标签内容。与通常不明确的字符串搜索相比,这具有巨大的优势,而字符串搜索对于在重命名标识符时使文档与源代码保持同步是必需的。
在某种程度上,它与nameof()运算符具有相似的功能,在构建字符串时很有用。区别在于,这可以在任何带有特殊标记的COMMENT中使用,而不是在代码中使用。