VS2008: автогенерированные файлы и документация XML

Это раздражение больше, чем проблема. Мой проект содержит несколько автогенерированных файлов (с использованием mgmtclassgen.exe). Когда я создаю XML-документацию, моя красиво прокомментированная библиотека страдает от документации документации xml из этих файлов autogen.

Есть ли способ: a) подавить генераторную документацию для этих файлов или b) подавить предупреждение CS1591 только для набора файлов? Я, очевидно, не хочу изменять файлы, автогенерируемые, даже если просто добавить прагмы подавления.

Библиотека и сгенерированный код находятся на С#, и я использую Visual Studio 2008.

Ответ 1

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

Ответ 2

Вы можете отключить определенные предупреждения с помощью директивы #pragma, это может подойти к вашей цели. Синтаксис для отключения предупреждения "Отсутствующий xml комментарий":

#pragma warning disable 1591    // Disable 'missing xml comment' warning

Вы можете повторно включить его, используя следующий синтаксис:

#pragma warning restore 1591    // Restore 'missing xml comment' warning

Это позволяет выборочно игнорировать предупреждения для любой части файла или полного файла.