Поделиться через

Файл конфигурации WsdCodeGen

  • Статья

Файл конфигурации WsdCodeGen обычно создается средством WsdCodeGen. Вы можете создать файлы конфигурации вручную, но сложность и длина файла, как правило, не позволяют выполнять ручное написание кода. Для создания файла настоятельно рекомендуется использовать WsdCodeGen. Дополнительные сведения о создании файлов конфигурации см. в разделе Использование синтаксиса командной строки WsdCodeGen и WsdCodeGen.

Необходимо проверить созданный файл конфигурации и при необходимости изменить его, прежде чем использовать его для создания исходного кода. Файла конфигурации, созданного WsdCodeGen, обычно достаточно для разработки большинства клиентов.

Чтобы использовать файл конфигурации для разработки сервера, необходимо внести некоторые изменения. Если размещение включено (т. е. если выбран режим all или host), при необходимости измените содержимое элемента ThisModelMetadata и его дочерних элементов. Кроме того, при необходимости измените или удалите элементы PnPXDeviceCategory, PnPXHardwareId и PnPXCompatibleId внутри элемента ThisModelMetadata или hosted .

Файл конфигурации состоит из последовательности элементов, которые предоставляют входные данные для создания кода, за которым следует любое количество элементов файла , описывающих создаваемые файлы. Входные данные включают несколько глобальных свойств и ссылок на типы, выраженные в 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, см. в справочнике по XML-файлу конфигурации WsdCodeGen.

Примеры файлов конфигурации включены в пакет Windows SDK. Дополнительные сведения см. в разделе Примеры WSDAPI.

Сведения о WsdCodeGen

Примеры WSDAPI