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ßen in der Regel eine 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.
Sie sollten die generierte Konfigurationsdatei überprüfen und ggf. ändern, bevor Sie sie zum Erstellen von Quellcode verwenden. Die von WsdCodeGen generierte Konfigurationsdatei ist in der Regel für die meisten Cliententwicklung 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 der zugehörigen untergeordneten Elemente nach Bedarf. Ändern oder entfernen Sie außerdem die PnPXDeviceCategory-, PnPXHardwareId- und PnPXCompatibleId-Elemente innerhalb des ThisModelMetadata-Elements oder hosted-Elements nach Bedarf.
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 enthalten einige globale Eigenschaften und Verweise auf Typen, die in WSDL, XSD und verwalteten Assemblys ausgedrückt werden. Text und CDATA in Dateielementen werden ohne Änderung in die generierten Dateien geschrieben. Andere Elemente in Dateielementen 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 Codegenerator-Hilfsprogramm formatiert zu werden. Diese lauten wie folgt:
Das Stammelement einer beliebigen Konfigurationsdatei ist wsdCodeGen.
Elemente, die einfache Datentypen enthalten, können mit Attributen ausgetauscht werden. 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 Reihenfolge 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 WsdCodeGen-Konfigurationsdatei-XML-Referenz.
Beispielkonfigurationsdateien sind im Windows SDK enthalten. Weitere Informationen finden Sie unter WSDAPI-Beispiele.
Zugehörige Themen