C# 在xml文档中,我可以插入对方法组的引用吗?怎么用?

C# 在xml文档中,我可以插入对方法组的引用吗?怎么用?,c#,.net,documentation,documentation-generation,C#,.net,Documentation,Documentation Generation,在C#中,我可以附加属性、方法、事件等的文档, 直接在代码中使用 我知道如何插入对特定方法的引用: <see cref="MethodName(TypeForArg1, TypeForArg2..)"/> 有没有办法插入对方法组的引用?我有多个相同方法名的重载 我试过了 <see cref="M:MethodName"/> …但这不起作用 编辑:BUMP显然没有办法做到这一点。至少在Visual Studio 2012中,这一点已经得到了解决: <see

在C#中,我可以附加属性、方法、事件等的文档, 直接在代码中使用

我知道如何插入对特定方法的引用:

<see cref="MethodName(TypeForArg1, TypeForArg2..)"/>

有没有办法插入对方法组的引用?我有多个相同方法名的重载

我试过了

<see cref="M:MethodName"/>

…但这不起作用


编辑:BUMP

显然没有办法做到这一点。

至少在Visual Studio 2012中,这一点已经得到了解决:

<see cref="MethodName"/>

要引用方法组,需要以下语法:

/// <summary>
/// Reference to a method group with two items:
/// <see cref="O:Full.Declaring.Namespace.TypeName.Foo"/>
/// </summary>
void Foo() { }
void Foo(int x) { }
//
///对包含两项的方法组的引用:
/// 
/// 
void Foo(){}
void Foo(int x){}
请注意,如前所述,此语法仍有一些限制

  • 生成期间未验证语法。在Sandcastle Help File Builder处理注释之前,不会报告键入时发生的错误
  • 只有当存在多个同名方法时,语法才起作用
  • 此语法没有语法突出显示或编辑器支持
这表明“M”前缀在生成的XML中是有效的,但我不确定这是否意味着该语法特别适用于方法组。像Sandcastle这样的文档工具是否能够正确地解释这些方法组引用?
/// <summary>
/// Reference to a method group with two items:
/// <see cref="O:Full.Declaring.Namespace.TypeName.Foo"/>
/// </summary>
void Foo() { }
void Foo(int x) { }