Partilhar via

Arquivo de configuração WsdCodeGen

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 WsdCodeGen para gerar o arquivo. Para obter mais informações sobre como gerar arquivos de configuração, consulte Usando o WsdCodeGen e de sintaxe de linha de comando 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 do desenvolvimento do cliente.

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

Um arquivo de configuração consiste em uma sequência de elementos que fornecem dados de entrada para geração de código, seguidos por qualquer número de arquivo elementos 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 arquivo elementos são gravados nos arquivos gerados sem modificação. Outros elementos em elementos de 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. São eles:

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

  • Os 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á restrição na ordenação dos 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 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 dos elementos usados nos arquivos de configuração WsdCodeGen, consulte WsdCodeGen Configuration File XML Reference.

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

Sobre o WsdCodeGen

Exemplos WSDAPI

 

 

  • Last updated on