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 o WsdCodeGen para gerar o arquivo. Para obter mais informações sobre como gerar arquivos de configuração, consulte Usando o WsdCodeGen e da 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 dos desenvolvimentos 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 elemento ThisModelMetadata e seus elementos filho, conforme necessário. Além disso, modifique ou remova os elementos PnPXDeviceCategory, PnPXHardwareIde elementos PnPXCompatibleId dentro do elemento ThisModelMetadata ou elementos de 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 seguido 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 no arquivo elementos são gravados nos arquivos gerados sem modificação. Outros elementos no arquivo elementos 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 do gerador de código. Estes 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, arquivo elementos 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.

Arquivos de configuração de exemplo são incluídos no SDK do Windows. Para obter mais informações, consulte exemplos do WSDAPI.

Tópicos relacionados

sobre o WsdCodeGen

exemplos do WSDAPI