/doc(C# 编译器选项)

/doc 选项允许在 XML 文件中放置文档注释。

/doc:file

实参

  • file
    XML 的输出文件,由编译的源代码文件中的注释填充。

备注

在源代码文件中,可处理以下内容之前的文档注释,并将其添加到 XML 文件中:

包含 Main 的源代码文件首先输出到 XML。

若要将生成的 .xml 文件用于Intellisense功能,请使该 .xml 文件的文件名与要支持的程序集同名,然后确保该 .xml 文件放入与该程序集相同的目录中。 这样,在 Visual Studio 项目中引用程序集时,也可找到该 .xml 文件。 有关更多信息,请参见提供代码注释

除非用 /target:module 进行编译,否则 file 将包含 <assembly></assembly> 标记,以指定包含编译输出文件的程序集清单的文件名。

提示

/doc 选项适用于所有输入文件;或者,如果此选项是在“项目设置”中设置的,则适用于项目中的所有文件。 若要禁用与特定的文件或代码段的文档注释相关的警告,请使用 #pragma warning

有关从代码中的注释生成文档的方法,请参见建议的文档注释标记

在 Visual Studio 开发环境中设置此编译器选项

  1. 打开项目的**“属性”**页。

  2. 单击**“生成”**选项卡。

  3. 修改**“XML 文档文件”**属性。

有关如何以编程方式设置此编译器选项的信息,请参见 DocumentationFile

请参见

其他资源

C# 编译器选项

项目属性 (Visual Studio)