Generieren eines WCF-Clients aus Dienstmetadaten

Artikel
09/12/2008

In diesem Thema wird beschrieben, wie die verschiedenen Schalter in Svcutil.exe verwendet werden, um aus Metadatendokumenten Clients zu generieren.

Die Metadatendokumente können sich in einem permanenten Speicher befinden oder online abgerufen werden. Der Onlineabruf erfolgt gemäß dem WS-MetadataExchange-Protokoll oder Microsoft Discovery (DISCO)-Protokoll. Svcutil.exe gibt zum Abruf von Metadaten die folgenden Metadatenanforderungen gleichzeitig aus.

WS-MetadataExchange (MEX)-Anforderung an die angegebene Adresse
MEX-Anforderung an die angegebene Adresse mit angefügtem /mex
DISCO-Anforderung (mit DiscoveryClientProtocol (möglicherweise nur in englischer Sprache verfügbar) von ASP.NET-Webdiensten) an die angegebene Adresse

Svcutil.exe generiert den Client auf der Basis der vom Dienst empfangenen WSDL (Web Services Description Language)-Datei oder Richtliniendatei. Der Benutzerprinzipalname (UPN) wird durch die Aneinanderreihung von Benutzername, "@" und vollqualifiziertem Domänennamen (FQDN) gebildet. Für in Active Directory registrierte Benutzer ist dieses Format jedoch nicht gültig, und der vom Tool generierte UPN verursacht einen Fehler bei der Kerberos-Authentifizierung mit der Fehlermeldung: Der Anmeldeversuch ist fehlgeschlagen. Um dieses Problem zu beheben, sollten Sie die von diesem Tool generierte Clientdatei manuell berichtigen.

svcutil.exe [/t:code]  <metadataDocumentPath>* | <url>* | <epr>

Verweisen auf Typen und Freigeben von Typen

Option	Beschreibung
/reference:<file path>	Verweist auf Typen in der angegebenen Assembly. Beim Generieren von Clients können Sie diese Option verwenden, um Assemblys anzugeben, die unter Umständen die Typen mit den zu importierenden Metadaten enthalten. Kurzform: /r.
/excludeType:<type>	Gibt einen vollqualifizierten oder assemblyqualifizierten Namen an, der aus den verwiesenen Vertragstypen ausgeschlossen werden soll. Kurzform: /et.

/reference:<file path>

Verweist auf Typen in der angegebenen Assembly. Beim Generieren von Clients können Sie diese Option verwenden, um Assemblys anzugeben, die unter Umständen die Typen mit den zu importierenden Metadaten enthalten.

Kurzform: /r.

/excludeType:<type>

Gibt einen vollqualifizierten oder assemblyqualifizierten Namen an, der aus den verwiesenen Vertragstypen ausgeschlossen werden soll.

Kurzform: /et.

Wählen eines Serialisierungsprogramms

Option	Beschreibung
/serializer:Auto	Das Serialisierungsprogramm wird automatisch ausgewählt. Hierbei wird das DataContract-Serialisierungsmodul verwendet. Wenn dieser Versuch fehlschlägt, wird XmlSerializer verwendet. Kurzform: /ser:Auto.
/serializer:DataContractSerializer	Generiert Datentypen, die das DataContract-Serilisierungsprogramm für die Serialisierung und die Deserialisierung verwenden. Kurzform: /ser:DataContractSerializer.
/serializer:XmlSerializer	Generiert Datentypen, die XmlSerializer für die Serialisierung und die Deserialisierung verwenden. Kurzform: /ser:XmlSerializer.
/importXmlTypes	Das DataContract-Serialisierungsprogramm wird so konfiguriert, dass Typen, die keine DataContract-Typen sind, als IXmlSerializable-Typen importiert werden. Kurzform: /ixt.
/dataContractOnly	Generiert nur Code für DataContract-Typen. Es werden ServiceContract-Typen generiert. Sie sollten für diese Option nur lokale Metadatendateien angeben. Kurzform: /dconly.

Auswählen einer Sprache für den Client

Option	Beschreibung
/language:<language>	Gibt die Programmiersprache an, die zur Codegenerierung verwendet werden soll. Sie können entweder einen in der Datei Machine.config registrierten Sprachnamen oder den vollqualifizierten Namen einer Klasse angeben, der von CodeDomProvider abgeleitet ist. Werte: c#, cs, csharp, vb, vbs, visualbasic, vbscript, javascript, c++, mc, cpp Standard: csharp Kurzform: /l. Weitere Informationen finden Sie unter CodeDomProvider-Klasse (Seite möglicherweise auf Englisch).

/language:<language>

Gibt die Programmiersprache an, die zur Codegenerierung verwendet werden soll. Sie können entweder einen in der Datei Machine.config registrierten Sprachnamen oder den vollqualifizierten Namen einer Klasse angeben, der von CodeDomProvider abgeleitet ist.

Werte: c#, cs, csharp, vb, vbs, visualbasic, vbscript, javascript, c++, mc, cpp

Standard: csharp

Kurzform: /l.

Weitere Informationen finden Sie unter CodeDomProvider-Klasse (Seite möglicherweise auf Englisch).

Auswählen eines Namespace für den Client

Option	Beschreibung
/namespace:<string,string>	Gibt eine Zuordnung von einem WSDL- oder XML-Schema-targetNamespace zu einem CLR (Common Language Runtime)-Namespace an. Durch die Verwendung eines Platzhalters () für targetNamespace* werden alle targetNamespaces ohne eine explizite Zuordnung diesem CLR-Namespace zugeordnet. Um zu gewährleisten, dass der Nachrichtenvertragsname nicht mit dem Vorgangsnamen in Konflikt steht, sollten Sie den Typverweis entweder mit zwei Doppelpunkten (::) angeben oder sicherstellen, dass die Namen einmalig sind. Standard: Wird vom Zielnamespace des Schemadokuments für DataContracts abgeleitet. Der Standardnamespace wird für alle anderen generierten Typen verwendet. Kurzform: /n.

/namespace:<string,string>

Gibt eine Zuordnung von einem WSDL- oder XML-Schema-targetNamespace zu einem CLR (Common Language Runtime)-Namespace an. Durch die Verwendung eines Platzhalters (*) für targetNamespace werden alle targetNamespaces ohne eine explizite Zuordnung diesem CLR-Namespace zugeordnet.

Um zu gewährleisten, dass der Nachrichtenvertragsname nicht mit dem Vorgangsnamen in Konflikt steht, sollten Sie den Typverweis entweder mit zwei Doppelpunkten (::) angeben oder sicherstellen, dass die Namen einmalig sind.

Standard: Wird vom Zielnamespace des Schemadokuments für DataContracts abgeleitet. Der Standardnamespace wird für alle anderen generierten Typen verwendet.

Kurzform: /n.

Auswählen einer Datenbindung

Option	Beschreibung
/enableDataBinding	Implementiert die INotifyPropertyChanged-Schnittstelle für alle generierten DataContract-Typen, um die Datenbindung zu ermöglichen. Kurzform: /edb.

/enableDataBinding

Implementiert die INotifyPropertyChanged-Schnittstelle für alle generierten DataContract-Typen, um die Datenbindung zu ermöglichen.

Kurzform: /edb.

Generieren der Konfiguration

Option	Beschreibung
/config:<configFile>	Gibt den Dateinamen für die generierte Konfigurationsdatei an. Standard: output.config.
/mergeConfig	Fügt die generierte Konfiguration in eine vorhandene Datei ein, statt die vorhandene Datei zu überschreiben.
/noConfig	Es werden keine Konfigurationsdateien generiert.

/config:<configFile>

Gibt den Dateinamen für die generierte Konfigurationsdatei an.

Standard: output.config.

/mergeConfig

Fügt die generierte Konfiguration in eine vorhandene Datei ein, statt die vorhandene Datei zu überschreiben.

/noConfig

Es werden keine Konfigurationsdateien generiert.

Siehe auch

Konzepte

Verwenden von Metadaten
Übersicht über die Metadatenarchitektur