C#,我可以将文件的性质,方法、事件等, 在代码中直接使用 XML文件的评论.

我知道怎么插入一个参照特定的方法:

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

有没有办法插入一个参照 方法小组?在那里我有多重载的相同方法的名字...

我试过了

<see cref="M:MethodName"/>

..但是没有工作。

编辑:

有帮助吗?

解决方案

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

其他提示

似乎至少在Visual Studio 2012中修复了这个问题:

<see cref="MethodName"/>

会产生警告:

  

cref属性中的模糊引用:'MethodName'。假设'&#8230;',但也可以匹配其他重载,包括'&#8230;'。

但是在前面添加 M:可以摆脱警告:

<see cref="M: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) { }

注意,这种语法并仍然有一些限制,以描述 这C#语言功能的要求.

  • 该法不是验证的期间建立。错误输入时没有报告,直到,如果/当Sandcastle帮助的文件生成器进程的意见。
  • 语法 如果有多种方法具有相同的名称。
  • 没有语法强调或编辑支持这种语法。
许可以下: CC-BY-SA归因
不隶属于 StackOverflow
scroll top