Отсутствуют итоговые теги для явно реализованных интерфейсов? - PullRequest
7 голосов
/ 14 сентября 2011

В основном у меня есть следующий код:

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:

Warn: 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. Любая помощь?

Ответы [ 4 ]

5 голосов
/ 19 декабря 2011

Убедитесь, что ваш проект создает файл документации xml.В свойствах проекта есть флажок для создания XML-файла.

enter image description here

4 голосов
/ 21 декабря 2011

Я уверен, что вы все перепробовали, и я знаю, что вы хотите знать, как это сделать, но я думаю, что это невозможно. Это ошибка в Sandcastle, и она до сих пор не исправлена ​​..: (

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

0 голосов
/ 18 декабря 2011

Это может быть проблема, вызванная кэшированием.В Sandcastle произошли изменения, которые требуют удаления старых файлов кэша с новым выпуском.Если они еще не удалены, они могут вызывать проблемы.Вы можете узнать, где найти файлы кэша и удалить их, в заметках о выпуске в разделе Breaking Changes.

0 голосов
/ 18 декабря 2011

Просто чтобы убедиться, вы пробовали это?

...