File di configurazione WsdCodeGen

Un file di configurazione WsdCodeGen viene in genere generato dallo strumento WsdCodeGen. È possibile creare manualmente i file di configurazione, ma la complessità e la lunghezza del file in genere impediscono la codifica manuale. È consigliabile usare WsdCodeGen per generare il file. Per altre informazioni sulla generazione di file di configurazione, vedere Using WsdCodeGen and WsdCodeGen Command Line Syntax.

È necessario esaminare il file di configurazione generato e, se necessario, modificarlo prima di usarlo per creare il codice sorgente. Il file di configurazione generato da WsdCodeGen è in genere sufficiente per la maggior parte dello sviluppo client.

Per usare il file di configurazione per lo sviluppo del server, sono necessarie alcune modifiche. Se l'hosting è abilitato (ad esempio, se è selezionata la modalità "all" o "host"), modificare il contenuto dell'elemento ThisModelMetadata e dei relativi elementi figlio in base alle esigenze. Modificare o rimuovere anche il PnPXDeviceCategory, PnPXHardwareIde elementi PnPXCompatibleId all'interno dell'elemento ThisModelMetadata o elementi Hosted in base alle esigenze.

Un file di configurazione è costituito da una sequenza di elementi che forniscono dati di input per la generazione di codice seguiti da un numero qualsiasi di file elementi che descrivono i file da generare. I dati di input includono alcune proprietà globali e riferimenti ai tipi espressi in assembly WSDL, XSD e gestiti. Testo e CDATA in file elementi vengono scritti nei file generati senza modifiche. Altri elementi nel file elementi vengono sostituiti nei file generati con codice generato.

I file di configurazione XML devono seguire alcune regole generali per essere formattati correttamente per l'uso con l'utilità del generatore di codice. Di seguito sono riportati i seguenti:

• L'elemento radice di qualsiasi file di configurazione è wsdCodeGen.

• Gli elementi che contengono tipi di dati semplici sono intercambiabili con attributi. Per esempio:

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

  equivale a:

  <wsdCodeGen layerNumber="1"/>
  

• In generale, non esiste alcun vincolo sull'ordinamento degli elementi. Per esempio:

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

  equivale a:

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

  Tuttavia, il generatore di codice elabora il file di configurazione in un singolo passaggio e l'ordinamento ha una certa rilevanza. Ad esempio, file elementi che generano codice relativo a un tipo di porta specifico devono verificarsi dopo l'elemento che indica al generatore di codice di leggere il contratto del tipo di porta.

Per un elenco completo degli elementi usati nei file di configurazione WsdCodeGen, vedere riferimento XML del file di configurazione WsdCodeGen.

I file di configurazione di esempio sono inclusi in Windows SDK. Per altre informazioni, vedere esempi WSDAPI .

Argomenti correlati

Informazioni su WsdCodeGen

esempi WSDAPI