每当我编写自己的XML注释并使用一些有用的标签(例如<c></c>
或<see cref=""/>
)时,intellisense弹出窗口都会显示文字XML而不是应用任何格式。通常,我仅出于智能目的编写XML注释,而不是使用sandcastle构建文档。有没有办法让智能感知来格式化我的XML标签,还是应该完全放弃它们?
我在Visual Studio和Visual Studio Code中都看到相同的行为。
我当之无愧。经过进一步研究后,我发现在原始问题中还有很多遗漏之处。仅当我编写“快捷方式”注释时才出现此问题,在该注释中,我忽略了<summary>
的实际XML标签,例如:
/// Adds 2 to <c>x</c>
int Add2(int x) => x + 2;
那些注释仍然显示在XML文档中,我认为这只是仅包含摘要的注释的简写形式。
此外,我还发现这些“快捷”注释的行为对于不同的语言是不同的。 F#显示了我在原始帖子中描述的问题:
与此同时,C#根本不在智能感知弹出窗口中呈现任何形式的注释:
我现在怀疑我的答案仅仅是Visual Studio和Visual Studio Code不太喜欢在省略<summary>
标记的地方添加注释。