Блог

Я включил создание XML — документации для своего проекта.

 lt;PropertyGroupgt;  lt;GenerateDocumentationFilegt;truelt;/GenerateDocumentationFilegt; lt;/PropertyGroupgt;  

Это создает множество предупреждений для моего проекта, потому что я не добавляю или не обновляю принудительно комментарии XML-документа для каждого типа или участника в моем проекте. Я отключил предупреждения с помощью другой тактически размещенной инструкции MSBuild.

 lt;PropertyGroupgt;  lt;NoWarngt;$(NoWarn);1591lt;/NoWarngt; lt;!-- CS1591: Missing XML comment for publicly visible type or member --gt;  lt;NoWarngt;$(NoWarn);1573lt;/NoWarngt; lt;!-- CS1573: Parameter '' has no matching param tag in the XML comment --gt; lt;/PropertyGroupgt;  

Теперь возникает вопрос, как мне восстановить предупреждения для файлов, в которых я хочу иметь чистую документацию или предупреждение?

То, что я пробовал, не сработало.

 #pragma warning restore CS1591,CS1573 public class Undocumented {  public void AlsoUndocumented(bool undocumented = true) { } }