/doc

将文档注释处理到一个 XML 文件中。

/doc[+ | -]
' -or-
/doc:file

参数

术语

定义

+ | -

可选。指定“+”或只指定 /doc,让编译器生成文档信息,并将这些信息放入一个 XML 文件中。指定 - 相当于不指定 /doc,不会创建任何文档信息。

file

如果使用了 /doc:,则是必选项。指定输出的 XML 文件,文件将包括被编译的源代码文件中的注释。如果文件名包含空格,则将该文件名置于引号 (" ") 中。

备注

/doc 选项控制编译器是否生成包含文档注释的 XML 文件。如果您使用 /doc:file 语法,则由 file 参数指定 XML 文件的名称。如果使用 /doc 或 /doc+,编译器则根据该编译器正创建的可执行文件或库使用一个 XML 文件名。如果使用 /doc- 或不指定 /doc 选项,则编译器不创建 XML 文件。

在源代码文件中,文档注释可以位于下面的定义之前:

若要使用以 Visual Studio IntelliSense 功能生成的 XML 文件,让 XML 文件的文件名与您要支持的程序集相同。确保 XML 文件与程序集位于同一个目录中,从而在 Visual Studio 项目中引用程序集时,也可以找到 .xml 文件。要让 IntelliSense 对项目中的代码或被一个项目引用的多个项目中的代码有效,XML 文档文件不是必选项。

如果不用 /target:module 编译,则 XML 文件包含标记 <assembly></assembly>。这些标记为编译的输出文件指定包含程序集清单的文件名。

有关根据代码中的注释生成文档的方法,请参见 建议的用于文档注释的 XML 标记 (Visual Basic)

在 Visual Studio 集成开发环境中设置 /doc

  1. “解决方案资源管理器”中选择一个项目。在“项目”菜单上,单击“属性”。有关更多信息,请参见项目设计器介绍

  2. 单击“编译”选项卡。

  3. 设置“生成 XML 文档文件”框中的值。

示例

有关示例,请参见 使用 XML 将代码文档化 (Visual Basic)

请参见

概念

使用 XML 将代码文档化 (Visual Basic)

其他资源

Visual Basic 命令行编译器