引用不明确的文档方法摘要答案

【问题标题】：Document method-summary with ambigious reference引用不明确的文档方法摘要
【发布时间】：2015-05-29 12:46:03
【问题描述】：

我有一个大规模重载的方法MethodA，它在我的MethodB 文档中的摘要标记中引用：

/// <summary>A link to <see cref="MethodA" /></summary>
void MethodB { ... }

评论不仅应该依赖于MethodA 的特殊重载，而且应该依赖于所有这些。但是，编译器会打印出 cref 属性不明确的消息（但这是有意的）。是否有解决此问题的最佳实践？我已经想过从summary 中完全删除see-tag。也许您还有其他方法？

【问题讨论】：

【解决方案1】：

我认为您有两个选择。要么参考评论中的具体方法：

/// <summary>A link to <see cref="MethodA(int)" /> or one of it's overloaded variants</summary>

或者，您可以添加M: prefix，这将消除错误，但可能不是您所需要的：

/// <summary>A link to <see cref="M:MethodA" /></summary>

【讨论】：