Arquivo de configuração WsdCodeGen

  • Artigo

Um arquivo de configuração WsdCodeGen geralmente é gerado pela ferramenta WsdCodeGen. Você pode criar arquivos de configuração manualmente, mas a complexidade e o comprimento do arquivo normalmente impedem a codificação manual. É altamente recomendável usar o WsdCodeGen para gerar o arquivo. Para obter mais informações sobre como gerar arquivos de configuração, consulte Usando a sintaxe de linha de comando WsdCodeGen e WsdCodeGen.

Você deve inspecionar o arquivo de configuração gerado e, se necessário, modificá-lo antes de usá-lo para criar o código-fonte. O arquivo de configuração gerado pelo WsdCodeGen normalmente é suficiente para a maioria dos desenvolvimentos de clientes.

Para usar o arquivo de configuração para desenvolvimento de servidor, algumas modificações são necessárias. Se a hospedagem estiver habilitada (ou seja, se "todos" ou o modo "host" estiver selecionado), modifique o conteúdo do elemento ThisModelMetadata e seus elementos filho, conforme necessário. Além disso, modifique ou remova os elementos PnPXDeviceCategory, PnPXHardwareId e PnPXCompatibleId dentro do elemento ThisModelMetadata ou elementos Hospedados , conforme necessário.

Um arquivo de configuração consiste em uma sequência de elementos que fornecem dados de entrada para a geração de código seguidos por qualquer número de elementos de arquivo que descrevem os arquivos a serem gerados. Os dados de entrada incluem algumas propriedades globais e referências a tipos expressos em WSDL, XSD e assemblies gerenciados. Texto e CDATA em elementos de arquivo são gravados nos arquivos gerados sem modificação. Outros elementos em elementos de arquivo são substituídos nos arquivos gerados pelo código gerado.

Os arquivos de configuração XML devem seguir algumas regras gerais para serem formatados corretamente para uso com o utilitário gerador de código. Eles são:

  • O elemento raiz de qualquer arquivo de configuração é wsdCodeGen.

  • Elementos que contêm tipos de dados simples são intercambiáveis com atributos. Por exemplo:

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

    é equivalente a:

    <wsdCodeGen layerNumber="1"/>

  • Em geral, não há nenhuma restrição na ordenação de elementos. Por exemplo:

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

    é equivalente a:

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

    No entanto, o gerador de código processa o arquivo de configuração em uma única passagem e a ordenação tem alguma relevância. Por exemplo, elementos de arquivo que geram código relacionado a um tipo de porta específico devem ocorrer após o elemento que instrui o gerador de código a ler o contrato de tipo de porta.

Para obter uma lista completa de elementos usados em arquivos de configuração WsdCodeGen, consulte Referência XML do arquivo de configuração WsdCodeGen.

Os arquivos de configuração de exemplo estão incluídos no SDK do Windows. Para obter mais informações, consulte Exemplos de WSDAPI.

Sobre o WsdCodeGen

Exemplos de WSDAPI