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

Question

基本上，我有以下代码：

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

MyProject.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.IDictionary.Add(TKek key, TValue value) 方法被识别为具有 XML 注释。事实上，所有隐式实现的 ICollection> 都是由 ICollection> 隐式实现的。方法给 Sandcastle 带来了问题。有什么帮助吗？

Answer 1

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

Answer 2

我确信你已经尝试过一切，我知道你想知道如何去做，但我认为这是不可能的。这是 Sandcastle 中的错误，而且还没有修复.. :(

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

Answer 3

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

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

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

Answer 4

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