File di configurazione WsdCodeGen

  • Articolo

Un file di configurazione WsdCodeGen viene in genere generato dallo strumento WsdCodeGen. È possibile creare file di configurazione manualmente, ma la complessità e la lunghezza del file in genere impedisce la codifica manuale. È consigliabile usare WsdCodeGen per generare il file. Per altre informazioni sulla generazione di file di configurazione, vedere Uso di WsdCodeGen e Sintassi della riga di comando WsdCodeGen.

È 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 i relativi elementi figlio in base alle esigenze. Modificare o rimuovere anche gli elementi PnPXDeviceCategory, PnPXHardwareId e PnPXCompatibleId all'interno dell'elemento ThisModelMetadata o Gli 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 qualsiasi numero di elementi di file 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 negli elementi di file vengono scritti nei file generati senza modifiche. Altri elementi negli elementi di file vengono sostituiti nei file generati con codice generato.

I file di configurazione XML devono seguire alcune regole generali per essere formattate correttamente per l'uso con l'utilità generatore di codice. Si tratta di:

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

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

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

    Equivale a:

    <wsdCodeGen layerNumber="1"/>

  • In generale, non esiste alcun vincolo sull'ordinamento degli elementi. Ad 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, gli elementi di file che generano codice relativi 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 di elementi usati nei file di configurazione WsdCodeGen, vedere Informazioni di riferimento sul file XML di configurazione WsdCodeGen.

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

Informazioni su WsdCodeGen

Esempi WSDAPI