Freigeben über

WsdCodeGen-Konfigurationsdatei

  • Artikel

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 Handcodierung aus. Es wird dringend empfohlen, die Datei mithilfe von WsdCodeGen zu generieren. Weitere Informationen zum Generieren von Konfigurationsdateien finden Sie unter Using WsdCodeGen and WsdCodeGen Command Line Syntax.

Sie sollten die generierte Konfigurationsdatei prüfen und ggf. ändern, bevor Sie sie zum Erstellen von Quellcode verwenden. Die von WsdCodeGen generierte Konfigurationsdatei reicht in der Regel für die meisten Cliententwicklung aus.

Um die Konfigurationsdatei für die Serverentwicklung zu verwenden, sind einige Änderungen erforderlich. Wenn das Hosting aktiviert ist (d. h., wenn der Modus "alle" oder "Host" ausgewählt ist), ändern Sie den Inhalt des ThisModelMetadata Element und dessen untergeordneten Elemente nach Bedarf. Ändern oder entfernen Sie außerdem die PnPXDeviceCategory, PnPXHardwareIdund PnPXCompatibleId Elemente innerhalb des ThisModelMetadata Element oder Hosted Elemente nach Bedarf.

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

XML-Konfigurationsdateien müssen einige allgemeine Regeln befolgen, um ordnungsgemäß für die Verwendung mit dem Codegeneratorprogramm formatiert zu werden. Dies sind:

  • Das Stammelement jeder Konfigurationsdatei ist wsdCodeGen.

  • Elemente, die einfache Datentypen enthalten, können mit Attributen austauschbar sein. Zum Beispiel:

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

    entspricht:

    <wsdCodeGen layerNumber="1"/>

  • Im Allgemeinen gibt es keine Einschränkung für die Anordnung von Elementen. Zum Beispiel:

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

    entspricht:

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

    Der Codegenerator verarbeitet jedoch die Konfigurationsdatei in einem einzigen Durchlauf, und die Sortierung hat eine gewisse Relevanz. Beispielsweise muss Datei Elemente, 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 WsdCodeGen Configuration File XML Reference.

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

Über WsdCodeGen

WSDAPI-Beispiele