c# - 显式实现的接口缺少摘要标签？

Question

基本上，我有以下代码：

public class MyDictionary<TKey, TValue> : IDictionary<TKey, TValue>
{
    /// <summary> My Summary </summary>
    void MyDictionary<TKey, TValue>.ICollection<KeyValuePair<TKey, TValue>> { ... }
}

我的项目.XML

<member name="M:MyProject.MyDictionary`2.System#Collection#Generic#ICollection{System#Collections#Generic#KeyValuePair{TKey@TValue}}#Clear">
 <summary>
  My Summary
 </summary>
</member>

Sandcastle 的内置输出：

警告：ShowMissingComponent：M:MyProject.MyDictionary`2.System#Collections#Generic#ICollection{T}#Clear 缺少文档

所以，不知道到底该怎么做。我确实让我的 Sandcastle 构建选项包含显式实现，这就是它在文档中为它们创建页面的原因，但它似乎无法弄清楚我确实为这个方法创建了 XML 注释。奇怪的是，该void MyDictionary<TKey, TValue>.IDictionary<TKey, TValue>.Add(TKek key, TValue value)方法被标识为具有 XML 注释。事实上，所有隐式实现的 ICollection> 方法都给 Sandcastle 带来了问题。有什么帮助吗？

Answer 1

确保您的项目正在构建 xml 文档文件。项目属性中有一个用于构建 xml 文件的复选框。

Answer 2

我敢肯定你什么都试过了，我知道你想知道怎么做，但我认为这是不可能的。这是 Sandcastle 中的错误，它还没有修复.. :(

http://sandcastle.codeplex.com/workitem/5594

Answer 3

这可能是由缓存引起的问题。Sandcastle 中的一些变化要求在新版本中删除旧的缓存文件。如果尚未删除，它们可能会导致问题。您可以在“重大更改”部分的发行说明中找到缓存文件的位置并删除它们。

Answer 4

只是为了确定，你试过这个吗？：

/// <summary>
/// My Summary 
/// </summary>

是的，我知道这意味着同样的事情，但这可能是一个解析问题。