c# - 代码实体引用 SandcaSTLe developerHowToDocument 上的方法

Question

我正在尝试使用 <codeEntityReference> 创建指向自定义扩展方法的链接MAML 元素，一旦我构建了文档，我就得到了整个 <codeEntityReference>标记内容而不是指向整个方法的链接。

该方法的示例是:

namespace SampleProject 
{
    public static class ExtensionMethods
    {
         public static bool SomeExtension<T>(this T some) => true;
    }
}

还有 <codeEntityReference>看起来像 <codeEntityReference>M:SampleProject.ExtensionMethods.SomeExtension{T}(TObject)</codeEntityReference>

上面的链接会产生类似M:SampleProject.ExtensionMethods.SomeExtension{T}(T)的输出。

实际上，我在文档构建过程中遇到了以下错误:

warning : BuildAssembler : warning : ResolveReferenceLinksComponent: [52e40f26-3dfe-47e0-adf1-09233e98f42e] Unknown reference link target 'M:SampleProject.ExtensionMethods.SomeExtension{T}(T)'

我错过了什么吗？那里出了什么问题？我尝试将方法引用提供为:

M:SampleProject.ExtensionMethods.SomeExtension`1

...但这并没有解决问题。

Answer 1

最后我解决了检查 C# 编译器如何为程序集生成 XML 文档文件的问题。

例如，<codeEntityReference>我的示例扩展方法是:

<codeEntityReference>
     M:SampleProject.ExtensionMethods.SomeExtension``1(``0)
</codeEntityReference>