Документация интерфейса не доступна из класса реализации интерфейса - PullRequest
6 голосов
/ 17 июня 2011

Могу ли я как-нибудь дать указание Visual Studio автоматически копировать документацию XML любого члена интерфейса в свой класс реализации?

Согласно этому Инструкции по MSDN , обновленные для этого точного эффекта всего 2 месяца назад, один должен.Но я никак не могу повторить это поведение.Также, глядя на файл XML в этой статье, на самом деле нет записи для реализации интерфейса.

Ответы [ 3 ]

2 голосов
/ 17 июня 2011

Я использую submain GhostDoc - это бесплатный визуальный студийный плагин, который автоматически документирует блоки кода, либо путем копирования из документации базового класса / интерфейса, либо разумно пытаясь угадать документацию (что удивительно эффективно). Я не мог развиваться без этого в наши дни.

1 голос
/ 17 июня 2011

Насколько я знаю, сама VS не может этого сделать. Наш VSdocman автоматически наследует комментарии от базовых и реализованных типов, когда генерирует документацию. Более того, он может явно добавить унаследованный комментарий в исходный код.

1 голос
/ 17 июня 2011

Вы можете использовать Конструктор файлов справки Sandcastle
<inheritdoc/>, что позволяет вам наследовать документацию от базовых типов.

Добро пожаловать на сайт PullRequest, где вы можете задавать вопросы и получать ответы от других членов сообщества.
...