MetadataExchangeClient Klasse

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 gezeigt MetadataExchangeClient , wie Sie eine Downloadbindung angeben, alle enthaltenen Verweise auf Metadaten auflösen und die Metadaten herunterladen.

// 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 zum Herunterladen von MetadataExchangeClient Metadaten. In der Regel wird eine MetadataExchangeClient Für eine Metadatenanforderung konfiguriert und dann an die oder MetadataResolver.Resolve die MetadataResolver.Resolve Methode MetadataResolver übergeben, die zum Herunterladen von Metadaten verwendet werden soll.

Sie können jedoch die MetadataExchangeClient Metadaten direkt als Objekt MetadataSet MetadataSection abrufen.

Ob direkt verwendet oder an ein MetadataResolverObjekt übergeben wird, MetadataExchangeClient verfügt über die folgenden Elemente, um den Metadatendownloadprozess zu steuern:

Verwenden Sie die Konstruktoren, um die Bindung anzupassen, die beim Erstellen der Metadatenanforderung verwendet werden soll.
Verwenden Sie die HttpCredentials Eigenschaft, um die Anmeldeinformationen anzugeben, die zum Erstellen einer HTTP/GET-Anforderung verwendet werden.
Verwenden Sie die SoapCredentials Eigenschaft, um die Anmeldeinformationen anzugeben, die zum Erstellen einer WS-Transfer Metadatenanforderung verwendet werden.
Verwenden Sie die MaximumResolvedReferences Eigenschaft, um die Anzahl der Metadatenverweise einzuschränken, die aufgelöst MetadataExchangeClient werden.
Verwenden Sie die OperationTimeout Eigenschaft, um den Zeitaufwand für das Abrufen von Metadaten zu begrenzen.
Verwenden Sie die ResolveMetadataReferences Eigenschaft, um anzugeben, ob andere Metadatendokumente gefunden und abgerufen werden sollen, auf die von den Metadaten verwiesen wird, die vom ursprünglichen Metadatenendpunkt heruntergeladen wurden.
Verwenden Sie die GetMetadata Methoden, um den Downloadvorgang zu starten.

Darüber hinaus können Sie eine abgeleitete Klasse erstellen, die die folgenden beiden geschützten Methoden außer Kraft setzen kann:

Überschreiben Sie die GetChannelFactory Methode, um den Kanal zu ändern, der eine Metadatenanforderung mithilfe von WS-Transfer vorgibt.
Überschreiben Sie die GetWebRequest Methode, um die HttpWebRequest Metadatenanforderung mithilfe von HTTP/GET zu ändern.

Konstruktoren

Name	Beschreibung
MetadataExchangeClient()	Initialisiert eine neue Instanz der MetadataExchangeClient-Klasse.
MetadataExchangeClient(Binding)	Initialisiert eine neue Instanz der Klasse mithilfe der MetadataExchangeClient 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

Name	Beschreibung
HttpCredentials	Ruft die Anmeldeinformationen ab, die zum Erstellen einer HTTP/GET-Anforderung verwendet werden, oder legt diese fest.
MaximumResolvedReferences	Ruft die maximale Anzahl von Verweisen auf Metadaten ab, die von den Downloads heruntergeladen werden, oder legt diese MetadataExchangeClient fest.
OperationTimeout	Dient zum Abrufen oder Festlegen des Zeitraums, in dem die Metadaten heruntergeladen werden müssen, bevor eine Ausnahme ausgelöst wird.
ResolveMetadataReferences	Dient zum Abrufen oder Festlegen eines Werts, der steuert, ob Verweise auf Metadaten aufgelöst werden.
SoapCredentials	Ruft die Clientsicherheitsanmeldeinformationen ab, die zum Erstellen einer WS-Transfer Metadatenanforderung verwendet werden, oder legt diese fest.

Methoden

Name	Beschreibung
BeginGetMetadata(AsyncCallback, Object)	Startet einen asynchronen Methodenaufruf, der eine MetadataSet.
BeginGetMetadata(EndpointAddress, AsyncCallback, Object)	Startet einen asynchronen Methodenaufruf, der eine MetadataSet verwendung der angegebenen Adresse, des Rückrufs und des asynchronen Zustands zurückgibt.
BeginGetMetadata(Uri, MetadataExchangeClientMode, AsyncCallback, Object)	Startet einen asynchronen Methodenaufruf, der eine MetadataSet verwendung der angegebenen Adresse, des Rückrufs, des asynchronen Zustands und des Downloadmechanismus zurückgibt.
EndGetMetadata(IAsyncResult)	Beendet einen asynchronen Methodenaufruf, der eine MetadataSet.
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
GetChannelFactory(EndpointAddress, String, String)	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die Kanalfactory zurückgegeben, die zum Erstellen der WS-Transfer Metadatenanforderung verwendet wird.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetMetadata()	Gibt ein MetadataSet.
GetMetadata(EndpointAddress, Uri)	Gibt eine MetadataSet von der angegebenen Adresse und auf der angegebenen Route zurück.
GetMetadata(EndpointAddress)	Gibt eine MetadataSet von der angegebenen Adresse zurück.
GetMetadata(Uri, MetadataExchangeClientMode)	Gibt eine MetadataSet von der angegebenen Adresse mithilfe des angegebenen Downloadmodus zurück.
GetMetadataAsync()	Gibt einen asynchronen Metadatensatz zurück.
GetMetadataAsync(EndpointAddress, Uri)	Gibt einen asynchronen Metadatensatz aus der angegebenen Adresse und auf der angegebenen Route zurück.
GetMetadataAsync(EndpointAddress)	Gibt einen asynchronen Metadatensatz aus der angegebenen Adresse zurück.
GetMetadataAsync(Uri, MetadataExchangeClientMode)	Gibt einen asynchronen Metadatensatz aus der angegebenen Adresse mithilfe des angegebenen Downloadmodus zurück.
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
GetWebRequest(Uri, String, String)	Wenn sie in einer abgeleiteten Klasse überschrieben werden, wird die HttpWebRequest zum Erstellen von HTTP/GET-Metadatenanforderungen verwendete Eigenschaft zurückgegeben.
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für:

Feedback

War diese Seite hilfreich?