c# - C#、XmlDoc：如何引用方法重载

Question

如果我有这两种方法

public Foo Get(string bar) { ... }
public Foo Get(int bar) { ... }

并以不同的方法编写这段 xml 文档

/// <summary>
/// Has a close relation to the <see cref="Get"/> methods.
/// </summary>

我得到一个蓝色波浪Get线，说它是一个不明确的参考 'Get'。这是真的，但我希望它引用两者。这样做的正确方法是什么？还是我应该只引用一个方法重载？

score 28 · Accepted Answer

尝试

/// Has a close relation to the <see cref="Get(string)"/>  
/// and <see cref="Get(int)" /> methods.

您可能需要完整的类型名，但一旦您放入第一个括号，智能感知应该会有所帮助。

希望有帮助，

担

score 3 · Accepted Answer

这是对这个旧问题的更新答案。我不确定这何时生效，因为那里没有太多文档。如果您在cref属性前面加上"o:..."诸如 in "o:myMethod()"，它将链接到重载部分并覆盖该方法的所有重载。使用 Daniel Elliott 的答案示例：

/// Has a close relation to the <see cref="o:Get()"/> methods.

这也将删除来自 Intellisense / Resharper 的关于模糊引用的警告。

2 回答 2