WsdCodeGen 配置文件

WsdCodeGen 配置文件通常由 WsdCodeGen 工具生成。 可以手动创建配置文件,但文件的复杂性和长度通常排除手动编码。 强烈建议使用 WsdCodeGen 生成文件。 有关生成配置文件的详细信息,请参阅 使用 WsdCodeGenWsdCodeGen 命令行语法

应检查生成的配置文件,如有必要,在使用它创建源代码之前对其进行修改。 WsdCodeGen 生成的配置文件通常足以用于大多数客户端开发。

若要将配置文件用于服务器开发,需要进行一些修改。 如果启用了托管(即,如果选择了“all”或“host”模式),请根据需要修改 ThisModelMetadata 元素及其子元素的内容。 此外,根据需要修改或删除 PnPXDeviceCategoryPnPXHardwareIdPnPXCompatibleId 元素 ThisModelMetadata 元素或 托管 元素。

配置文件包含一系列元素,这些元素为代码生成提供输入数据,后跟任意数量的 文件 描述要生成的文件的元素。 输入数据包括一些全局属性和对 WSDL、XSD 和托管程序集中表示的类型引用。 文件中的文本和 CDATA 元素将写入生成的文件,而无需修改。 文件中的其他元素 元素在生成的文件中替换为生成的代码。

XML 配置文件必须遵循一些常规规则才能正确设置格式,以便与代码生成器实用工具一起使用。 以下是:

  • 任何配置文件的根元素 wsdCodeGen

  • 包含简单数据类型的元素可与属性互换。 例如:

    <wsdCodeGen>
        <layerNumber>1</layerNumber>
    </wsdCodeGen>
    

    等效于:

    <wsdCodeGen layerNumber="1"/>
    
  • 一般情况下,元素排序没有约束。 例如:

    <wsdCodeGen>
        <layerNumber>1</layerNumber>
        <layerPrefix>MEDIA_</layerPrefix>
    </wsdCodeGen>
    

    等效于:

    <wsdCodeGen>
        <layerPrefix>MEDIA_</layerPrefix>
        <layerNumber>1</layerNumber>
    </wsdCodeGen>
    

    但是,代码生成器在单个传递中处理配置文件,排序确实具有一些相关性。 例如,文件 生成与特定端口类型相关的代码的元素必须在指示代码生成器读取端口类型协定的元素之后发生。

有关 WsdCodeGen 配置文件中使用的元素的完整列表,请参阅 WsdCodeGen 配置文件 XML 参考

Windows SDK 包含示例配置文件。 有关详细信息,请参阅 WSDAPI 示例

关于 WsdCodeGen

WSDAPI 示例