文件元素

指示代码生成器生成文件并指定输出文件名。

使用情况

<file
  name = "pathname string">
  child elements
</file>

特性

属性	类型	必须	说明
name	pathname 字符串	是	所生成内容的输出文件名。 文件名字符串应包含完整的路径信息。

子元素

元素	说明
Cdata	文本和 CDATA 部分无需修改即可复制到文件。 可以使用文本和 CDATA 部分将不是协定输入数据的函数的源代码添加到输出文件中。
enumerationValueDeclarations	为所有枚举类型的值生成 C 声明。
eventSourceBuilderDeclarations	为创建事件源类的函数生成声明。
eventSourceBuilderImplementations	生成用于创建事件源类的函数。
functionDeclarations	为端口类型操作的代理函数生成实现声明。
hostBuilderDeclaration	为创建类型化主机的函数生成声明。
hostBuilderImplementation	生成用于创建类型化主机的函数。
idlFunctionDeclarations	为端口类型操作的代理函数生成 IDL 声明。
include	在生成的输出中包含宏或文件的内容。
IUnknownDeclarations	生成 QueryInterface、AddRef 和 Release 的声明。
IUnknownDefinitions	生成 QueryInterface、AddRef 和 Release 的实现。
literalInclude	将 C 或 IDL include 语句放在生成的代码中。
messageStructureDefinitions	生成消息类型的 C 结构定义。
messageTypeDeclarations	为消息类型的 XML 架构表生成 C 常量声明。
messageTypeDefinitions	为消息类型的 XML 架构表生成 C 常量。
namespaceDeclarations	为命名空间表生成 C 声明。
namespaceDefinitions	为命名空间表生成 C 定义。
portTypeDeclarations	为端口类型生成 C 常量声明。
portTypeDefinitions	为端口类型生成 C 常量。
proxyBuilderDeclarations	为函数生成声明以创建类型化代理。
proxyBuilderImplementations	生成函数以创建类型化代理。
proxyFunctionImplementations	为端口类型操作生成代理函数的实现。
relationshipMetadataDeclaration	为 hostMetadata 元素中指定的宿主元数据生成向前声明。
relationshipMetadataDefinition	为 hostMetadata 元素中指定的宿主元数据生成 C 常量定义。
structDeclarations	为已知类型生成 C 结构声明。
structDefinitions	生成已知类型的 C 结构定义。
stubDeclarations	为端口类型操作生成存根函数的声明。
stubDefinitions	为端口类型操作生成存根函数的实现。
subscriptionFunctionDeclarations	为端口类型通知操作的订阅/取消订阅代理函数生成实现声明。
subscriptionIdlFunctionDeclarations	为端口类型通知操作的 subscribe/unsubscribe 代理函数生成 IDL 声明。
subscriptionProxyFunctionImplementations	为端口类型通知操作的订阅/取消订阅代理函数生成实现。
text	文本和 CDATA 部分无需修改即可复制到文件。 可以使用文本和 CDATA 部分将不是协定输入数据的函数的源代码添加到输出文件中。
thisModelMetadataDeclaration	为 thisModelMetadata 元素中指定的制造商元数据的 C 常量生成向前声明。
thisModelMetadataDefinition	为 thisModelMetadata 元素中指定的制造商元数据生成 C 常量。
typeTableDeclarations	为已知类型的 XML 架构表生成 C 常量声明。
typeTableDefinitions	为已知类型的 XML 架构表生成 C 常量。

子元素序列

(
  text, 
  CDATA, 
  namespaceDeclarations*, 
  namespaceDefinitions*, 
  structDeclarations*, 
  structDefinitions*, 
  typeTableDeclarations*, 
  typeTableDefinitions*, 
  thisModelMetadataDeclaration*, 
  thisModelMetadataDefinition*, 
  portTypeDeclarations*, 
  portTypeDefinitions*, 
  messageStructureDefinitions*, 
  messageTypeDeclarations*, 
  messageTypeDefinitions*, 
  idlFunctionDeclarations*, 
  subscriptionIdlFunctionDeclarations*, 
  functionDeclarations*, 
  subscriptionFunctionDeclarations*, 
  proxyFunctionImplementations*, 
  subscriptionProxyFunctionImplementations*, 
  stubDeclarations*, 
  stubDefinitions*, 
  enumerationValueDeclarations*, 
  include*, 
  IUnknownDeclarations*, 
  IUnknownDefinitions*, 
  relationshipMetadataDeclaration*, 
  relationshipMetadataDefinition*, 
  proxyBuilderDeclarations*, 
  proxyBuilderImplementations*, 
  hostBuilderDeclaration*, 
  hostBuilderImplementation*, 
  eventSourceBuilderDeclarations*, 
  eventSourceBuilderImplementations*, 
  literalInclude*
)

父元素

元素	说明
wsdCodeGen	WSDAPI 代码生成器 XML 脚本文件的根元素。

备注

文件的名称由 name 属性或子元素的值确定。 文件的内容由文件元素中的其他子元素（文本和 CDATA）确定。 文本和 CDATA 未修改地复制到文件中。 子元素将替换为生成的代码。 文本、CDATA 和子元素可以按任意顺序出现，并可以无限期重复。

元素信息

Label	值
最低支持系统	Windows Vista
可为空	否