WsdCodeGen 配置文件

  • 项目

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

应检查生成的配置文件，并在必要时对其进行修改，然后再使用它来创建源代码。 WsdCodeGen 生成的配置文件通常足以用于大多数客户端开发。

若要使用配置文件进行服务器开发，需要进行一些修改。 如果 (启用托管，即在) 选择了“全部”或“主机”模式，请根据需要修改 ThisModelMetadata 元素及其子元素的内容。 此外，根据需要修改或删除 ThisModelMetadata 元素或 Hosted 元素中的 PnPXDeviceCategory、PnPXHardwareId 和 PnPXCompatibleId 元素。

配置文件由一系列元素组成，这些元素为代码生成提供输入数据，后跟描述要生成的文件的任意数量的 文件 元素。 输入数据包括一些全局属性和对以 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 示例