c# - 如何显示内容在 Intellisense 和 DocFx 的 XML 注释中查看 cref？

Question

我在一个列表类型的属性上使用了 XML 注释。

然而，当我将鼠标悬停在该属性上时，Visual Studio 将其显示为 List<T> .

当我使用 docFx 构建文档时，它仍将注释呈现为 List<T>而不是 List<ClassXXXX> .

我试过previous post推荐的方案了在这里，但它不起作用。

下面是带有C#代码的XML注释，供您引用:

/// <summary>
/// Gets and sets the <see cref="List{T}"/> .
/// </summary>
public List<ClassXXXX> ListFoo { get; set; }

我可以在 XML 注释中做什么才能看到 List<ClassXXXX>在智能感知和文档中？

谢谢

Answer 1

在 标签中明确设置你想要的文本:

/// Gets and sets the <see cref="List{T}">List&lt;ClassXXXX&gt;</see> .

您不能直接在 cref 属性中指定 List 。 cref 是对类型定义及其文档的引用。没有类型 List 也没有它的文档。只有 List 可以创建链接。但链接文本可能是您需要的任何内容。