これは問題というより厄介です。私のプロジェクトには、(mgmtclassgen.exe を使用して) 自動生成された多数のファイルが含まれています。XML ドキュメントを生成すると、美しくコメントされたライブラリが、これらの autogen ファイルからの xml ドキュメントの警告に悩まされます。
a) これらのファイルのドキュメントの生成を抑制する方法、または b) 一連のファイルに対してのみ警告 CS1591 を抑制する方法はありますか? 抑制プラグマを追加するだけでも、自動生成されたファイルを変更したくないことは明らかです。
ライブラリと生成されたコードは両方とも C# であり、私は Visual Studio 2008 を使用しています。
AFAIKは、特定のファイルに対してのみこの警告を抑制することはできません。これらの警告が本当に気になる場合は、自動生成されたコードを別のアセンブリに移動して、XMLドキュメントを無効にすることができます。
#pragma ディレクティブを使用して特定の警告を無効にすることができます。これは目的に適している場合があります。「xml コメントがありません」という警告を無効にする構文は次のとおりです。
#pragma warning disable 1591 // Disable 'missing xml comment' warning
次の構文を使用して、再度有効にすることができます。
#pragma warning restore 1591 // Restore 'missing xml comment' warning
これにより、ファイルの一部またはファイル全体の警告を選択的に無視できます。