在xml文件,我可以插入一个参考方法的小组?怎么样?
-
05-07-2019 - |
题
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帮助的文件生成器进程的意见。
- 语法 只 如果有多种方法具有相同的名称。
- 没有语法强调或编辑支持这种语法。
不隶属于 StackOverflow