# /doc (C# Compiler Options) **/doc** 選項允許在 XML 文件中放置文檔注釋。 ## 語法 ``` /doc:file ``` ## 參數 _file_ XML 的輸出文件，由編譯的源代碼文件中的注釋填充。 ## 備注 在源代碼文件中，可處理以下內容之前的文檔注釋，并將其添加到 XML 文件中： * 用戶定義的類型，如 [class](https://msdn.microsoft.com/zh-CN/library/0b0thckt.aspx)、[delegate](https://msdn.microsoft.com/zh-CN/library/900fyy8e.aspx) 或 [interface](https://msdn.microsoft.com/zh-CN/library/87d83y5b.aspx) * 成員，如字段、[事件](https://msdn.microsoft.com/zh-CN/library/8627sbea.aspx)、[屬性](https://msdn.microsoft.com/zh-CN/library/w86s7x04.aspx)或方法 包含 Main 的源代碼文件首先輸出到 XML。 若要將生成的 .xml 文件用于[Intellisense](https://msdn.microsoft.com/zh-CN/library/hcw1s69b.aspx)功能，請使該 .xml 文件的文件名與要支持的程序集同名，然后確保該 .xml 文件放入與該程序集相同的目錄中。這樣，在 Visual Studio 項目中引用程序集時，也可找到該 .xml 文件。有關更多信息，請參見[提供代碼注釋](https://msdn.microsoft.com/zh-CN/library/s0we08bk.aspx)。 除非用 [/target:module](https://msdn.microsoft.com/zh-CN/library/58scf68s.aspx) 進行編譯，否則 _file_ 將包含 <assembly></assembly>，以指定包含編譯輸出文件的程序集清單的文件名。 |  注意 | | :-- | | /doc 選項適用于所有輸入文件；或者，如果此選項是在“項目設置”中設置的，則適用于項目中的所有文件。若要禁用與特定的文件或代碼段的文檔注釋相關的警告，請使用 [#pragma warning](https://msdn.microsoft.com/zh-CN/library/441722ys.aspx)。 | 有關從代碼中的注釋生成文檔的方法，請參見[建議的文檔注釋標記](https://msdn.microsoft.com/zh-CN/library/5ast78ax.aspx)。 ## 在 Visual Studio 開發環境中設置此編譯器選項 1. 打開項目的**“屬性”**頁。 2. 單擊**“生成”**選項卡。 3. 修改**“XML 文檔文件”**屬性。 有關如何以編程方式設置此編譯器選項的信息，請參見 [DocumentationFile](https://msdn.microsoft.com/zh-CN/library/t071996d.aspx)。 ## 請參閱 [C# Compiler Options](https://msdn.microsoft.com/zh-CN/library/2fdbz5xd.aspx) [如何：修改項目屬性和配置設置](https://msdn.microsoft.com/zh-CN/library/z15yzzew.aspx)