如何在C＃中的标记中创建一个cref to方法重载？

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

我试过了：

MyMethod Overloads 

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

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

Answer 1

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

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

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

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

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

Answer 2

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

 ///  static void Foo() { } ///  ///  <------ complains static void Foo(int a) { } 

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

Answer 3

使用Sandcastle很简单：

 MyMethod Overloads 

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

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