首页 > 解决方案 > Visual Studio Intellisense 格式 XML 标记

问题描述

每当我编写自己的 XML 注释并使用一些有用的标签(如<c></c>or <see cref=""/>)时,智能感知弹出窗口会显示文字 XML,而不是应用任何格式。我通常只是为了智能感知而不是使用沙堡构建文档而编写 XML 注释。有没有办法让智能感知来格式化我的 XML 标签,或者我应该完全放弃它们?

我在 Visual Studio 和 Visual Studio Code 中都看到了相同的行为。

编辑

我应得的反对票。在进一步研究之后,我发现我在原始问题中遗漏了更多内容。仅当我编写“快捷方式”注释时才会出现问题,其中我省略了 的实际 XML 标记<summary>,例如:

/// Adds 2 to <c>x</c>
int Add2(int x) => x + 2;

这些注释仍然显示在 XML 文档中,我认为它只是仅包含摘要的注释的简写。

此外,我还发现这些“快捷方式”注释的行为对于不同的语言是不同的。F# 显示了我在原始帖子中描述的问题: 在此处输入图像描述

同时,C# 根本不会在智能感知弹出窗口中呈现任何类型的注释: 在此处输入图像描述

我现在怀疑我的答案只是 Visual Studio 和 Visual Studio Code 不喜欢你离开<summary>标签的注释。

标签: c#visual-studiovisual-studio-codeintellisensexml-documentation

解决方案


推荐阅读