MetadataExchangeClient Klasse

Referenz

Definition

Namespace:: System.ServiceModel.Description

Assembly:: System.ServiceModel.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Lädt Dienstmetadaten herunter.

public ref class MetadataExchangeClient

public class MetadataExchangeClient

type MetadataExchangeClient = class

Public Class MetadataExchangeClient

Vererbung: Object
MetadataExchangeClient

Beispiele

Im folgenden Codebeispiel wird die Verwendung des MetadataExchangeClient zum Angeben einer Downloadbindung, zum Auflösen aller enthaltenen Verweise auf Metadaten und zum Herunterladen der Metadaten veranschaulicht.

// Get metadata documents.
Console.WriteLine("URI of the metadata documents retreived:");
MetadataExchangeClient metaTransfer
  = new MetadataExchangeClient(httpGetMetaAddress.Uri, MetadataExchangeClientMode.HttpGet);
metaTransfer.ResolveMetadataReferences = true;
MetadataSet otherDocs = metaTransfer.GetMetadata();
foreach (MetadataSection doc in otherDocs.MetadataSections)
    Console.WriteLine(doc.Dialect + " : " + doc.Identifier);

Hinweise

Verwenden Sie den MetadataExchangeClient, um Metadaten herunterzuladen. In der Regel wird ein MetadataExchangeClient für eine Metadatenanforderung konfiguriert und dann an die MetadataResolver.Resolve- oder MetadataResolver.Resolve-Methode für den MetadataResolver zum Download der Metadaten übergeben.

Sie können jedoch direkt über den MetadataExchangeClient Metadaten als MetadataSet mit MetadataSection-Objekten abrufen.

Unabhängig von der direkten Verwendung oder Übergabe an einen MetadataResolver verfügt der MetadataExchangeClient über folgende Member zur Steuerung des Downloads von Metadaten:

Passen Sie die bei der Metadatenanforderung zu verwendende Bindung mithilfe der Konstruktoren an.
Geben Sie die für eine HTTP/GET-Anforderung zu verwendenden Anmeldeinformationen mithilfe der HttpCredentials-Eigenschaft an.
Geben Sie die für eine WS-Transfer-Metadatenanforderung zu verwendenden Anmeldeinformationen mithilfe der SoapCredentials-Eigenschaft an.
Mithilfe der MaximumResolvedReferences-Eigenschaft können Sie die Anzahl der durch den MetadataExchangeClient aufgelösten Metadatenverweise begrenzen.
Mithilfe der OperationTimeout-Eigenschaft können Sie die Zeit für den Abruf der Metadaten begrenzen.
Mithilfe der ResolveMetadataReferences-Eigenschaft können Sie angeben, ob andere Metadatendokumente gesucht und abgerufen werden sollen, auf die durch die vom ursprünglichen Metadaten-Endpunkt heruntergeladenen Metadaten verwiesen wird.
Mithilfe der GetMetadata-Methoden können Sie den Downloadvorgang beginnen.

Zudem können Sie eine abgeleitete Klasse erstellen, die die folgenden zwei geschützten Methoden überschreiben kann:

Überschreiben Sie die GetChannelFactory-Methode, um den Kanal zu ändern, der mit WS-Transfer eine Metadatenanforderung durchführt.
Überschreiben Sie die GetWebRequest-Methode, um die HttpWebRequest zu ändern, die mit HTTP/GET eine Metadatenanforderung durchführt.

Konstruktoren

MetadataExchangeClient()	Initialisiert eine neue Instanz der MetadataExchangeClient-Klasse.
MetadataExchangeClient(Binding)	Initialisiert eine neue Instanz der MetadataExchangeClient-Klasse unter Verwendung der angegebenen Bindung.
MetadataExchangeClient(EndpointAddress)	Initialisiert eine neue Instanz der MetadataExchangeClient-Klasse.
MetadataExchangeClient(String)	Initialisiert eine neue Instanz der MetadataExchangeClient-Klasse.
MetadataExchangeClient(Uri, MetadataExchangeClientMode)	Initialisiert eine neue Instanz der MetadataExchangeClient-Klasse.

Eigenschaften

HttpCredentials	Ruft die Anmeldeinformationen zur Durchführung einer HTTP/GET-Anforderung ab oder legt diese fest.
MaximumResolvedReferences	Ruft die Höchstanzahl der Verweise auf Metadaten ab, die vom MetadataExchangeClient heruntergeladen werden.
OperationTimeout	Ruft den Zeitraum ab oder legt den Zeitraum fest, innerhalb dessen die Metadaten heruntergeladen werden müssen, bevor eine Ausnahme ausgelöst wird.
ResolveMetadataReferences	Ruft einen Wert ab oder legt einen Wert fest, der kontrolliert, ob Verweise auf Metadaten aufgelöst werden.
SoapCredentials	Dient zum Abrufen oder Festlegen der Client-Sicherheitsanmeldeinformationen, die für eine WS-Transfer-Metadatenanforderung verwendet werden.

Methoden

BeginGetMetadata(AsyncCallback, Object)	Startet einen asynchronen Methodenaufruf, der einen MetadataSet zurückgibt.
BeginGetMetadata(EndpointAddress, AsyncCallback, Object)	Startet einen asynchronen Methodenaufruf, der einen MetadataSet mit der angegebenen Adresse, dem Rückruf und dem asynchronen Zustand zurückgibt.
BeginGetMetadata(Uri, MetadataExchangeClientMode, AsyncCallback, Object)	Startet einen asynchronen Methodenaufruf, der einen MetadataSet mit der angegebenen Adresse, dem Rückruf, dem asynchronen Zustand und dem Downloadmechanismus zurückgibt.
EndGetMetadata(IAsyncResult)	Beendet einen asynchronen Methodenaufruf, der einen MetadataSet zurückgibt.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetChannelFactory(EndpointAddress, String, String)	Gibt beim Überschreiben in einer abgeleiteten Klasse die Kanalfactory zurück, die für die WS-Transfer-Metadatenanforderung verwendet wird.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetMetadata()	Gibt einen Wert vom Typ MetadataSet zurück.
GetMetadata(EndpointAddress)	Gibt einen MetadataSet für die angegebene Adresse zurück.
GetMetadata(EndpointAddress, Uri)	Gibt einen MetadataSet von der angegebenen Adresse und auf der angegeben Route zurück.
GetMetadata(Uri, MetadataExchangeClientMode)	Gibt einen MetadataSet im angegebenen Downloadmodus über die angegebene Adresse zurück.
GetMetadataAsync()	Gibt ein asynchrones Metadatenset zurück.
GetMetadataAsync(EndpointAddress)	Gibt ein asynchrones Metadatenset aus der angegebenen Adresse zurück.
GetMetadataAsync(EndpointAddress, Uri)	Gibt ein asynchrones Metadatenset aus der angegebenen Adresse und auf der angegeben Route zurück.
GetMetadataAsync(Uri, MetadataExchangeClientMode)	Gibt ein asynchrones Metadatenset aus der angegebenen Adresse unter Verwendung des angegebenen Downloadmodus zurück.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetWebRequest(Uri, String, String)	Gibt beim Überschreiben in einer abgeleiteten Klasse die HttpWebRequest zur Ausführung von HTTP/GET-Metadatenanforderungen zurück.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für