file

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

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

• 用户定义的类型，如 class、delegate 或 interface

• 成员，如字段、事件、属性或方法

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

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

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

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

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

有关示例，请参见 “XML 文档”示例。

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

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

任务

其他资源