WsdCodeGen-Konfigurationsdatei

Eine WsdCodeGen-Konfigurationsdatei wird normalerweise vom WsdCodeGen-Tool generiert. Sie können Konfigurationsdateien manuell erstellen, aber die Komplexität und Länge der Datei schließt in der Regel die Manuelle Codierung aus. Es wird dringend empfohlen, WsdCodeGen zum Generieren der Datei zu verwenden. Weitere Informationen zum Generieren von Konfigurationsdateien finden Sie unter Verwenden von WsdCodeGen und WsdCodeGen-Befehlszeilensyntax.

Überprüfen Sie die generierte Konfigurationsdatei, und ändern Sie sie bei Bedarf, bevor Sie sie zum Erstellen von Quellcode verwenden. Die von WsdCodeGen generierte Konfigurationsdatei ist in der Regel für die meisten Cliententwicklungen ausreichend.

Um die Konfigurationsdatei für die Serverentwicklung zu verwenden, sind einige Änderungen erforderlich. Wenn das Hosting aktiviert ist (d. h. wenn der Modus "all" oder "host" ausgewählt ist), ändern Sie den Inhalt des ThisModelMetadata-Elements und seiner untergeordneten Elemente nach Bedarf. Ändern oder entfernen Sie nach Bedarf auch die Elemente PnPXDeviceCategory, PnPXHardwareIdund PnPXCompatibleId innerhalb des ThisModelMetadata-Elements oder der Hosted-Elemente.

Eine Konfigurationsdatei besteht aus einer Sequenz von Elementen, die Eingabedaten für die Codegenerierung bereitstellen, gefolgt von einer beliebigen Anzahl von Dateielementen, die die zu generierenden Dateien beschreiben. Eingabedaten umfassen einige globale Eigenschaften und Verweise auf Typen, die in WSDL, XSD und verwalteten Assemblys ausgedrückt werden. Text und CDATA in Dateielementen werden ohne Änderungen in die generierten Dateien geschrieben. Andere Elemente in Dateielementen werden in den generierten Dateien durch generierten Code ersetzt.

XML-Konfigurationsdateien müssen einigen allgemeinen Regeln folgen, damit sie ordnungsgemäß für die Verwendung mit dem Codegenerator-Hilfsprogramm formatiert werden können. Diese lauten wie folgt:

  • Das Stammelement jeder Konfigurationsdatei ist wsdCodeGen.

  • Elemente, die einfache Datentypen enthalten, sind mit Attributen austauschbar. Beispiel:

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

    entspricht:

    <wsdCodeGen layerNumber="1"/>
    
  • Im Allgemeinen gibt es keine Einschränkung für die Reihenfolge von Elementen. Beispiel:

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

    entspricht:

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

    Der Codegenerator verarbeitet die Konfigurationsdatei jedoch in einem einzigen Durchlauf, und die Sortierung hat eine gewisse Relevanz. Beispielsweise müssen Dateielemente, die Code generieren, der sich auf einen bestimmten Porttyp bezieht, nach dem -Element auftreten, das den Codegenerator anweist, den Porttypvertrag zu lesen.

Eine vollständige Liste der Elemente, die in WsdCodeGen-Konfigurationsdateien verwendet werden, finden Sie unter XML-Referenz zur WsdCodeGen-Konfigurationsdatei.

Beispielkonfigurationsdateien sind im Windows SDK enthalten. Weitere Informationen finden Sie unter WSDAPI-Beispiele.

Informationen zu WsdCodeGen

WSDAPI-Beispiele