Visual Studio Intellisense格式XML标签

时间:2018-07-11 04:00:56

标签: c# visual-studio visual-studio-code intellisense xml-documentation

每当我编写自己的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#显示了我​​在原始帖子中描述的问题: enter image description here

与此同时,C#根本不在智能感知弹出窗口中呈现任何形式的注释: enter image description here

我现在怀疑我的答案仅仅是Visual Studio和Visual Studio Code不太喜欢在省略<summary>标记的地方添加注释。

0 个答案:

没有答案