如何使一个cref方法重载一个 <seealso> C＃中的标签？

Question

我在MSDN链接中看到诸如“CompareOrdinal Overloads”。 如何在C＃中编写这样的链接？

我试过了：

<seealso cref="MyMethod">MyMethod Overloads</seealso>

但编译器给出了一个警告，即对于具有其他重载的方法是一个模糊的引用。

（初学者问题：我是否真的需要编写此标记来链接到重载，还是由文档处理器自动生成？）

Answer 1

针对特定成员，我相信您只是匹配签名：

/// <seealso cref="Foo(int)"/>
static void Foo() { }
/// <seealso cref="Foo()"/>
/// <seealso cref="Foo(float)"/> <------ complains
static void Foo(int a) { }

说实话，我不确定如何生成“所有重载”链接; 我假设任何合理的发电机都会自动完成。

Answer 2

使用Sandcastle很简单：

<seealso cref="overloads:FullyQualifiedMyMethod">MyMethod Overloads</seealso>

FullyQualifiedMyMethod是达到重载所需的完整路由，包括名称空间和类，即：System.Linq.Enumerable.Sum

但是，VB编译器会发出一条警告，说明该属性无法解析，可以忽略。

Answer 3

Xml文档没有方法来引用方法的所有重载。

最流行的C＃项目文档生成器是Sandcastle。 如有必要，它将自动创建指向重载列表页面的链接。 因此，在成员列表页面中，重载方法的名称只出现一次，单击它将导航到该方法的重载列表页面，并从那里导航到特定的重载。

在Xml文档中放置一个指向重载列表页面的链接需要熟悉所使用的外部工具，这可能不是一个好主意。

如果你真的必须拥有它，那么也许一种方法是使用具有特定形式ID的锚。 大多数文档生成器提供了一些预处理或后处理生成文件的神秘方法，并且应该让您有机会选择这些锚点并为它们提供适当的href。

其他，它可能比它的价值更麻烦;）