Gewusst wie: Verwenden von Svcutil.exe zum Herunterladen von MetadatendokumentenHow to: Use Svcutil.exe to Download Metadata Documents

Svcutil.exe kann verwendet werden, um Metadaten aus ausgeführten Diensten herunterzuladen und die Metadaten in lokalen Dateien zu speichern.You can use Svcutil.exe to download metadata from running services and to save the metadata to local files. Bei HTTP und HTTPS-URL-Schemas versucht Svcutil.exe zum Abrufen von Metadaten mit WS-MetadataExchange und XML-Webdienstsuche.For HTTP and HTTPS URL schemes, Svcutil.exe attempts to retrieve metadata using WS-MetadataExchange and XML Web Service Discovery. Bei allen anderen URL-Schemas verwendet Svcutil.exe nur WS-MetadataExchange.For all other URL schemes, Svcutil.exe uses only WS-MetadataExchange.

Standardmäßig verwendet Svcutil.exe die in der MetadataExchangeBindings-Klasse definierten Bindungen.By default, Svcutil.exe uses the bindings defined in the MetadataExchangeBindings class. Wenn Sie die für WS-MetadataExchange verwendete Bindung konfigurieren möchten, müssen Sie einen Clientendpunkt in der Konfigurationsdatei für "Svcutil.exe" (svcutil.exe.config) definieren, der den IMetadataExchange-Vertrag verwendet und über dasselbe URI-Schema der Metadaten-Endpunktadresse verfügt.To configure the binding used for WS-MetadataExchange, you must define a client endpoint in the configuration file for Svcutil.exe (svcutil.exe.config) that uses the IMetadataExchange contract and that has the same name as the Uniform Resource Identifier (URI) scheme of the metadata endpoint address.

Achtung

Beim Ausführen von Svcutil.exe zum Abrufen von Metadaten für einen Dienst, der zwei anderen Dienst verfügbar macht, Verträge, die jeweils einen Vorgang mit dem gleichen Namen enthalten, werden Svcutil.exe eine Fehlermeldung, "Kann nicht in Metadaten abgerufen werden..." angezeigt. Z. B. Wenn Sie einen Dienst verwenden, der einen Dienstvertrag namens verfügbar macht "icarservice", die ein Vorgang Get (Car c), und der gleiche Dienst macht einen Dienstvertrag namens "IBookService", die ein Get (Book b Vorgang).When running Svcutil.exe to get metadata for a service that exposes two different service contracts that each contain an operation of the same name, Svcutil.exe displays an error saying, "Cannot obtain Metadata from ...." For example, if you have a service that exposes a service contract called ICarService that has an operation Get(Car c) and the same service exposes a service contract called IBookService that has an operation Get(Book b). Verwenden Sie eine der folgenden Vorgehensweisen, um dieses Problem zu umgehen:To work around this issue, do one of the following:

  • Benennen Sie eine der Operationen um.Rename one of the operations
    • Legen Sie die Name-Eigenschaft auf einen anderen Namen fest.Set the Name to a different name.
    • Legen Sie einen der Namespaces der Operation mit der Namespace-Eigenschaft auf einen anderen Namespace fest.Set one of the operations' namespaces to a different namespace using the Namespace property.

So laden Sie Metadaten mit Svcutil.exe herunterTo download metadata using Svcutil.exe

  1. Suchen Sie das Tool Svcutil.exe am folgenden Speicherort:Locate the Svcutil.exe tool at the following location:

    C:\Programme\Microsoft SDKs\Windows\v1.0.\binC:\Program Files\Microsoft SDKs\Windows\v1.0.\bin

  2. Starten Sie das Tool an der Eingabeaufforderung mit dem folgenden Format.At the command prompt, launch the tool using the following format.

    svcutil.exe /t:metadata  <url>* | <epr>  
    

    Um Metadaten herunterzuladen, müssen Sie die /t:metadata-Option angeben.You must specify the /t:metadata option to download metadata. Andernfalls werden Clientcode und -konfiguration generiert.Otherwise, client code and configuration are generated.

  3. Die <url>-Argument gibt die URL zu einem Dienstendpunkt, der Metadaten bereitstellt, oder zu einem Metadatendokument, das online gehostet.The <url>argument specifies the URL to a service endpoint that provides metadata or to a metadata document hosted online. Die <epr>-Argument gibt den Pfad zu einer XML-Datendatei, die einen WS-Adressierung enthält EndpointAddress für einen Dienstendpunkt, der WS-MetadataExchange unterstützt.The <epr> argument specifies the path to an XML file that contains a WS-Addressing EndpointAddress for a service endpoint that supports WS-MetadataExchange.

Weitere Optionen zur Verwendung dieses Tools zum Herunterladen von Metadaten finden Sie unter ServiceModel Metadata Utility Tool (Svcutil.exe).For more options about using this tool for metadata download, see ServiceModel Metadata Utility Tool (Svcutil.exe).

BeispielExample

Der folgende Befehl lädt Metadatendokumente aus einem ausführenden Dienst herunter.The following command downloads metadata documents from a running service.

svcutil /t:metadata http://service/metadataEndpoint  

Siehe auchSee Also

ServiceModel Metadata Utility-Tool (Svcutil.exe)ServiceModel Metadata Utility Tool (Svcutil.exe)