3

Я включил следующую xmlDoc установки в моем projec.json файле:Настройки Project.json На основании решения Конфигурации

"buildOptions": { 
    "xmlDoc": true 
} 

Я только хочу прокомментировать некоторые из моих контроллеров MVC для поддержки Swashbuckle и я получаю много предупреждений жалующегося что остальная часть моего кода раскоментирована. Есть ли способ включить эту настройку только в режиме Release?

ответ

2
"buildOptions": { 
    "emitEntryPoint": true, 
    "preserveCompilationContext": true, 
    "xmlDoc": true, 
    "nowarn": [ "CS1591" ] 
}, 
+2

Было бы хорошо, если бы вы могли дать короткое предложение, объясняющее, почему это работает (и что именно это делает). Имейте в виду, что многие другие люди тоже могли бы это прочитать. – Seb

4

Да, вы можете включить XML документацию только в режиме выпуска, добавив следующие строки в project.json:

"configurations": { 
    "Release": { 
    "buildOptions": { 
     "xmlDoc": true 
    } 
    } 
}, 

Другим вариантом было бы быть полностью игнорировать это предупреждение, добавив "nowarn": ["CS1591"] в "buildOptions".