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

Question

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

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

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

我已经尝试过之前帖子推荐的解决方案，但它不起作用。

这是带有 C# 代码的 XML 注释供您参考：

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

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

谢谢

Answer 1

在 <see> 标记中明确设置您想要的文本：

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

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