Abrufen von MetadatenRetrieving Metadata

Das Abrufen von Metadaten ist der Prozess, Metadaten von einem Metadatenendpunkt, wie einem MEX-Medadatenendpunkt (WS-MetadataExchange) oder einem HTTP/GET-Metadatenendpunkt, anzufordern und abzurufen.Metadata retrieval is the process of requesting and retrieving metadata from a metadata endpoint, such as a WS-MetadataExchange (MEX) metadata endpoint or an HTTP/GET metadata endpoint.

Abrufen von Metadaten mit Svcutil.exe in der BefehlszeileRetrieving Metadata from the Command Line Using Svcutil.exe

Sie können mithilfe von WS-MetadataExchange oder HTTP/GET-Anforderungen mithilfe von Dienstmetadaten Abrufen der ServiceModel Metadata Utility Tool (Svcutil.exe) Tool und die Übertragung des der /target:metadata Switch- und eine Adresse.You can retrieve service metadata using WS-MetadataExchange or HTTP/GET requests by using the ServiceModel Metadata Utility Tool (Svcutil.exe) tool and passing the /target:metadata switch and an address. Svcutil.exe lädt die Metadaten bei der angegebenen Adresse herunter und speichert die Datei auf Datenträger.Svcutil.exe downloads the metadata at the specified address and saves the file to disk. Svcutil.exe verwendet intern eine System.ServiceModel.Description.MetadataExchangeClient-Instanz und lädt die IMetadataExchange-Endpunktkonfiguration, deren Name mit dem Schema der an Svcutil.exe als Eingabe weitergegebenen Adresse übereinstimmt, aus der Konfiguration.Svcutil.exe uses a System.ServiceModel.Description.MetadataExchangeClient instance internally and loads from configuration the IMetadataExchange endpoint configuration whose name matches the scheme of the address passed to Svcutil.exe as input.

Programmgesteuertes Abrufen von Metadaten mit dem MetadataExchangeClientRetrieving Metadata Programmatically Using the MetadataExchangeClient

Windows Communication Foundation (WCF)Windows Communication Foundation (WCF) kann Dienstmetadaten mithilfe standardisierter Protokolle, wie z. B. WS-MetadataExchange- und HTTP/GET-Anforderungen, abrufen. can retrieve service metadata using standardized protocols such as WS-MetadataExchange and HTTP/GET requests. Beide Protokolle werden vom MetadataExchangeClient-Typ unterstützt.Both of these protocols are supported by the MetadataExchangeClient type. Dienstmetadaten werden mit dem System.ServiceModel.Description.MetadataExchangeClient-Typ abgerufen, indem eine Adresse für den Metadatenendpunkt und eine optionale Bindung angegeben werden.You retrieve service metadata using the System.ServiceModel.Description.MetadataExchangeClient type by providing an address for the metadata endpoint and an optional binding. Bei der von einer System.ServiceModel.Description.MetadataExchangeClient-Instanz verwendeten Bindung kann es sich um eine der Standardbindungen aus der statischen MetadataExchangeBindings-Klasse, eine vom Benutzer angegebene Bindung oder eine aus einer Endpunktkonfiguration für den IMetadataExchange-Vertrag geladene Bindung handeln.The binding used by a System.ServiceModel.Description.MetadataExchangeClient instance can be one of the default bindings from the MetadataExchangeBindings static class, a user-supplied binding, or a binding loaded from an endpoint configuration for the IMetadataExchange contract. Der System.ServiceModel.Description.MetadataExchangeClient kann auch HTTP-URL-Verweise auf Metadaten mit dem HttpWebRequest-Typ auflösen.The System.ServiceModel.Description.MetadataExchangeClient can also resolve HTTP URL references to metadata using the HttpWebRequest type.

Standardmäßig wird eine System.ServiceModel.Description.MetadataExchangeClient-Instanz an eine einzelne ChannelFactory-Instanz gebunden.By default, a System.ServiceModel.Description.MetadataExchangeClient instance is tied to a single ChannelFactory instance. Sie können die System.ServiceModel.ChannelFactory-Instanz, die von einem System.ServiceModel.Description.MetadataExchangeClient verwendet wird, durch Überschreiben der virtuellen GetChannelFactory-Methode ändern oder ersetzen.You can change or replace the System.ServiceModel.ChannelFactory instance used by a System.ServiceModel.Description.MetadataExchangeClient by overriding the GetChannelFactory virtual method. Ebenso können Sie die HttpWebRequest-Instanz, die von einem System.ServiceModel.Description.MetadataExchangeClient zur Erstellung von HTTP/GET-Anforderungen verwendet wird, durch Überschreiben der virtuellen MetadataExchangeClient.GetWebRequest-Methode ändern oder ersetzen.Similarly, you can change or replace the HttpWebRequest instance used by a System.ServiceModel.Description.MetadataExchangeClient to make HTTP/GET requests by overriding the MetadataExchangeClient.GetWebRequest virtual method.

In diesem AbschnittIn This Section

Vorgehensweise: Verwenden von „Svcutil.exe“ zum Herunterladen von MetadatendokumentenHow to: Use Svcutil.exe to Download Metadata Documents
Veranschaulicht, wie Svcutil.exe zum Herunterladen von Metadatendokumenten verwendet wird.Demonstrates how to use Svcutil.exe to download metadata documents.

Vorgehensweise: Verwenden von MetadataResolver, um Bindungsmetadaten dynamisch zu erhaltenHow to: Use MetadataResolver to Obtain Binding Metadata Dynamically
Veranschaulicht, wie der System.ServiceModel.Description.MetadataResolver verwendet wird, um Bindungsmetadaten zur Laufzeit dynamisch zu erhalten.Demonstrates how to use the System.ServiceModel.Description.MetadataResolver to obtain binding metadata dynamically at runtime.

Vorgehensweise: Verwenden von MetadataExchangeClient zum Abrufen von MetadatenHow to: Use MetadataExchangeClient to Retrieve Metadata
Veranschaulicht, wie eine System.ServiceModel.Description.MetadataExchangeClient-Klasse zum Herunterladen von Metadatendateien in ein System.ServiceModel.Description.MetadataSet-Objekt verwendet wird, das System.ServiceModel.Description.MetadataSection-Objekte zum Schreiben in Dateien oder für andere Zwecke enthält.Demonstrates how to use the System.ServiceModel.Description.MetadataExchangeClient class to download metadata files into a System.ServiceModel.Description.MetadataSet object that contains System.ServiceModel.Description.MetadataSection objects to write to files or for other uses.

Siehe auchSee Also

MetadataExchangeClient