Выборочно подавите Комментарии кода XML в C#?

Мы поставляем много блоков внешним клиентам, но не все общедоступные API официально поддерживаются. Например, из-за меньше, чем оптимальных проектных решений иногда тип должен быть публично выставлен от блока для остальной части нашего кода для работы, но мы не хотим, чтобы клиенты использовали тот тип. Одна часть передачи отсутствия поддержки не, обеспечивают любой intellisense в форме XML-комментариев.

Существует ли способ выборочно подавить XML-комментарии? Я ищу что-то другое, чем игнорирование предупреждения 1591, так как это - долгосрочная проблема обслуживания.

Пример: у Меня есть блок с общедоступными классами A и B. A официально поддерживается и должен иметь документацию XML. B не предназначается для наружного применения и не должен быть зарегистрирован. Я мог включить документацию XML и затем подавить предупреждение 1591. Но когда я позже добавляю официально поддерживаемый класс C, я хочу, чтобы компилятор сказал мне, что я завинтил и не удался добавить документацию XML. Это не произошло бы, если я подавил 1591 на уровне проекта. Я предполагаю, что мог #pragma через все классы, но кажется, что должен быть лучший способ сделать это.

6
задан John Saunders 19 March 2010 в 01:05
поделиться