MetadataExchangeClient Klasa

Definicja

Przestrzeń nazw:

System.ServiceModel.Description

Zestaw:

System.ServiceModel.dll

Pobiera metadane usługi.

public ref class MetadataExchangeClient

public class MetadataExchangeClient

type MetadataExchangeClient = class

Public Class MetadataExchangeClient

Dziedziczenie

Object

MetadataExchangeClient

Przykłady

W poniższym przykładzie kodu przedstawiono sposób MetadataExchangeClient określania powiązania pobierania, rozpoznawania wszystkich zawartych odwołań do metadanych i pobierania metadanych.

// 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);

Uwagi

Użyj polecenia MetadataExchangeClient , aby pobrać metadane. Zazwyczaj element jest skonfigurowany dla żądania metadanych, MetadataExchangeClient a następnie przekazywany do metody MetadataResolver or MetadataResolver.Resolve do użycia do MetadataResolver.Resolve pobierania metadanych.

Można jednak użyć MetadataExchangeClient bezpośrednio do pobrania metadanych jako obiektu zawierającego MetadataSet MetadataSection obiekty.

Niezależnie od tego, czy jest używany bezpośrednio, czy przekazywany do elementu MetadataResolver, MetadataExchangeClient mają następujące elementy członkowskie do kontrolowania procesu pobierania metadanych:

• Użyj konstruktorów, aby dostosować powiązanie do użycia podczas wysyłania żądania metadanych.

• HttpCredentials Użyj właściwości , aby określić poświadczenia użyte do utworzenia żądania HTTP/GET.

• SoapCredentials Użyj właściwości , aby określić poświadczenia użyte do utworzenia żądania WS-Transfer metadanych.

• Użyj właściwości , MaximumResolvedReferences aby ograniczyć liczbę odwołań do metadanych rozpoznanych MetadataExchangeClient .

• Użyj właściwości , OperationTimeout aby ograniczyć czas spędzony na pobieraniu metadanych.

• ResolveMetadataReferences Użyj właściwości , aby określić, czy zlokalizować i pobrać inne dokumenty metadanych, do których odwołuje się metadane pobrane z oryginalnego punktu końcowego metadanych.

• GetMetadata Użyj metod, aby rozpocząć proces pobierania.

Ponadto można utworzyć klasę pochodną, która może zastąpić następujące dwie chronione metody:

• Zastąp metodę modyfikowania kanału GetChannelFactory , który wysyła żądanie metadanych przy użyciu usługi WS-Transfer.

• Zastąpij metodę GetWebRequest w celu zmodyfikowania HttpWebRequest żądania metadanych przy użyciu protokołu HTTP/GET.

Konstruktory

MetadataExchangeClient()	Inicjuje nowe wystąpienie klasy MetadataExchangeClient.
MetadataExchangeClient(Binding)	Inicjuje MetadataExchangeClient nowe wystąpienie klasy przy użyciu określonego powiązania.
MetadataExchangeClient(EndpointAddress)	Inicjuje nowe wystąpienie klasy MetadataExchangeClient.
MetadataExchangeClient(String)	Inicjuje nowe wystąpienie klasy MetadataExchangeClient.
MetadataExchangeClient(Uri, MetadataExchangeClientMode)	Inicjuje nowe wystąpienie klasy MetadataExchangeClient.

Właściwości

HttpCredentials	Pobiera lub ustawia poświadczenia używane do tworzenia żądania HTTP/GET.
MaximumResolvedReferences	Pobiera lub ustawia maksymalną liczbę odwołań do metadanych pobieranych MetadataExchangeClient .
OperationTimeout	Pobiera lub ustawia okres, w którym należy pobrać metadane przed zgłoszeniem wyjątku.
ResolveMetadataReferences	Pobiera lub ustawia wartość, która określa, czy odwołania do metadanych są rozpoznawane.
SoapCredentials	Pobiera lub ustawia poświadczenia zabezpieczeń klienta używane do tworzenia WS-Transfer żądania metadanych.

Metody

BeginGetMetadata(AsyncCallback, Object)	Rozpoczyna wywołanie metody asynchronicznej zwracające wartość MetadataSet.
BeginGetMetadata(EndpointAddress, AsyncCallback, Object)	Rozpoczyna wywołanie metody asynchronicznej, które zwraca MetadataSet przy użyciu określonego adresu, wywołania zwrotnego i stanu asynchronicznego.
BeginGetMetadata(Uri, MetadataExchangeClientMode, AsyncCallback, Object)	Rozpoczyna wywołanie metody asynchronicznej, które zwraca MetadataSet przy użyciu określonego adresu, wywołania zwrotnego, stanu asynchronicznego i mechanizmu pobierania.
EndGetMetadata(IAsyncResult)	Kończy asynchroniczne wywołanie metody, które zwraca wartość MetadataSet.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetChannelFactory(EndpointAddress, String, String)	Po zastąpieniu klasy pochodnej zwraca fabrykę kanałów używaną do wysyłania żądania metadanych WS-Transfer.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetMetadata()	Zwraca wartość MetadataSet.
GetMetadata(EndpointAddress)	Zwraca wartość MetadataSet z określonego adresu.
GetMetadata(EndpointAddress, Uri)	Zwraca element MetadataSet z określonego adresu i na określonej trasie.
GetMetadata(Uri, MetadataExchangeClientMode)	Zwraca wartość MetadataSet z określonego adresu przy użyciu określonego trybu pobierania.
GetMetadataAsync()	Zwraca asynchroniczny zestaw metadanych.
GetMetadataAsync(EndpointAddress)	Zwraca asynchroniczny zestaw metadanych z określonego adresu.
GetMetadataAsync(EndpointAddress, Uri)	Zwraca asynchroniczne metadane ustawione z określonego adresu i na określonej trasie.
GetMetadataAsync(Uri, MetadataExchangeClientMode)	Zwraca asynchroniczny zestaw metadanych z określonego adresu przy użyciu określonego trybu pobierania.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetWebRequest(Uri, String, String)	Po przesłonięciu w klasie pochodnej funkcja zwraca HttpWebRequest wartość używaną do wykonywania żądań metadanych HTTP/GET.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)