MetadataExchangeClient Klasa

Definicja

Pobiera metadane usługi.Downloads service metadata.

public ref class MetadataExchangeClient
public class MetadataExchangeClient
type MetadataExchangeClient = class
Public Class MetadataExchangeClient
Dziedziczenie
MetadataExchangeClient

Przykłady

Poniższy przykład kodu pokazuje, MetadataExchangeClient jak używać do określania powiązania pobierania, rozwiązywania wszelkich zawartych odwołań do metadanych i pobierania metadanych.The following code example shows the use of MetadataExchangeClient to specify a download binding, resolve any contained references to metadata, and download the metadata.

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

Pobieranie metadanych przy użyciu programu MetadataExchangeClient .Use the MetadataExchangeClient to download metadata. Zazwyczaj MetadataExchangeClient jest skonfigurowany dla żądania metadanych, a następnie przeszedł do MetadataResolver.Resolve metody lub w celu użycia w MetadataResolver.Resolve MetadataResolver celu pobrania metadanych.Typically, a MetadataExchangeClient is configured for a metadata request and then passed to the MetadataResolver.Resolve or MetadataResolver.Resolve method for the MetadataResolver to use to download metadata.

Można jednak użyć MetadataExchangeClient bezpośrednio do pobierania metadanych jako MetadataSet zawierających MetadataSection obiekty.However, you can use the MetadataExchangeClient directly to retrieve metadata as a MetadataSet that contains MetadataSection objects.

Bez względu na to, czy program został użyty bezpośrednio, czy przeszedł do MetadataResolver , MetadataExchangeClient ma następujących członków do sterowania procesem pobierania metadanych:Whether used directly or passed to a MetadataResolver, MetadataExchangeClient has the following members to control the metadata download process:

  • Użyj konstruktorów, aby dostosować powiązanie do użycia podczas wykonywania żądania metadanych.Use the constructors to customize the binding to use when making the metadata request.

  • Użyj HttpCredentials właściwości, aby określić poświadczenia używane do wysyłania żądania HTTP/GET.Use the HttpCredentials property to specify the credentials used to make an HTTP/GET request.

  • Użyj SoapCredentials właściwości, aby określić poświadczenia używane do przesyłania żądania metadanych WS-Transfer.Use the SoapCredentials property to specify the credentials used to make a WS-Transfer metadata request.

  • Użyj MaximumResolvedReferences właściwości, aby ograniczyć liczbę metadanych odwołujących się do MetadataExchangeClient rozwiązywania.Use the MaximumResolvedReferences property to limit the number of metadata references the MetadataExchangeClient resolves.

  • Użyj OperationTimeout właściwości, aby ograniczyć czas poświęcony na pobieranie metadanych.Use the OperationTimeout property to limit the time spent retrieving metadata.

  • Użyj ResolveMetadataReferences właściwości, aby określić, czy odszukać i pobrać inne dokumenty metadanych, do których odwołuje się metadane pobrane z oryginalnego punktu końcowego metadanych.Use the ResolveMetadataReferences property to specify whether to locate and retrieve other metadata documents referred to by the metadata downloaded from the original metadata endpoint.

  • Użyj GetMetadata metod, aby rozpocząć proces pobierania.Use the GetMetadata methods to begin the downloading process.

Ponadto można utworzyć klasę pochodną, która może przesłonić następujące dwie metody chronione:In addition, you can create a derived class that can override the following two protected methods:

  • Zastąp GetChannelFactory metodę, aby zmodyfikować kanał, który wysyła żądanie metadanych przy użyciu usługi WS-transfer.Override the GetChannelFactory method to modify the channel that makes a metadata request using WS-Transfer.

  • Zastąp GetWebRequest metodę modyfikacją HttpWebRequest , która powoduje żądanie metadanych przy użyciu protokołu HTTP/GET.Override the GetWebRequest method to modify the HttpWebRequest that makes a metadata request using HTTP/GET.

Konstruktory

MetadataExchangeClient()

Inicjuje nowe wystąpienie klasy MetadataExchangeClient.Initializes a new instance of the MetadataExchangeClient class.

MetadataExchangeClient(Binding)

Inicjuje nowe wystąpienie MetadataExchangeClient klasy przy użyciu określonego powiązania.Initializes a new instance of the MetadataExchangeClient class using the specified binding.

MetadataExchangeClient(EndpointAddress)

Inicjuje nowe wystąpienie klasy MetadataExchangeClient.Initializes a new instance of the MetadataExchangeClient class.

MetadataExchangeClient(String)

Inicjuje nowe wystąpienie klasy MetadataExchangeClient.Initializes a new instance of the MetadataExchangeClient class.

MetadataExchangeClient(Uri, MetadataExchangeClientMode)

Inicjuje nowe wystąpienie klasy MetadataExchangeClient.Initializes a new instance of the MetadataExchangeClient class.

Właściwości

HttpCredentials

Pobiera lub ustawia poświadczenia używane do wysyłania żądania HTTP/GET.Gets or sets the credentials used to make an HTTP/GET request.

MaximumResolvedReferences

Pobiera lub ustawia maksymalną liczbę odwołań do metadanych MetadataExchangeClient pobieranych przez pliki.Gets or sets the maximum number of references to metadata that the MetadataExchangeClient downloads.

OperationTimeout

Pobiera lub ustawia okres, w którym metadane muszą zostać pobrane przed zgłoszeniem wyjątku.Gets or sets the period of time within which the metadata must be downloaded before an exception is thrown.

ResolveMetadataReferences

Pobiera lub ustawia wartość, która kontroluje, czy odwołania do metadanych są rozpoznawane.Gets or sets a value that controls whether references to metadata are resolved.

SoapCredentials

Pobiera lub ustawia poświadczenia zabezpieczeń klienta używane do przesyłania żądania metadanych WS-Transfer.Gets or sets the client security credentials used to make a WS-Transfer metadata request.

Metody

BeginGetMetadata(AsyncCallback, Object)

Rozpoczyna wywołanie metody asynchronicznej, które zwraca MetadataSet .Begins an asynchronous method call that returns a 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.Begins an asynchronous method call that returns a MetadataSet using the specified address, callback, and asynchronous state.

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.Begins an asynchronous method call that returns a MetadataSet using the specified address, callback, asynchronous state, and download mechanism.

EndGetMetadata(IAsyncResult)

Przerywa wywołanie metody asynchronicznej, które zwraca MetadataSet .Ends an asynchronous method call that returns a MetadataSet.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetChannelFactory(EndpointAddress, String, String)

Gdy jest zastępowany w klasie pochodnej, zwraca fabrykę kanałów, która jest używana do przesyłania żądania metadanych WS-Transfer.When overridden in a derived class, returns the channel factory that is used to make the WS-Transfer metadata request.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetMetadata()

Zwraca wartość MetadataSet.Returns a MetadataSet.

GetMetadata(EndpointAddress)

Zwraca MetadataSet z podanego adresu.Returns a MetadataSet from the specified address.

GetMetadata(EndpointAddress, Uri)

Zwraca MetadataSet z podanego adresu i określonej trasy.Returns a MetadataSet from the specified address and on the specified route.

GetMetadata(Uri, MetadataExchangeClientMode)

Zwraca MetadataSet z podanego adresu przy użyciu określonego trybu pobierania.Returns a MetadataSet from the specified address using the specified download mode.

GetMetadataAsync()

Zwraca asynchroniczny zestaw metadanych.Returns an asynchronous metadata set.

GetMetadataAsync(EndpointAddress)

Zwraca asynchroniczny zestaw metadanych z podanego adresu.Returns an asynchronous metadata set from the specified address.

GetMetadataAsync(EndpointAddress, Uri)

Zwraca asynchroniczny zestaw metadanych z określonego adresu i określonej trasy.Returns an asynchronous metadata set from the specified address and on the specified route.

GetMetadataAsync(Uri, MetadataExchangeClientMode)

Zwraca asynchroniczny zestaw metadanych z określonego adresu przy użyciu określonego trybu pobierania.Returns an asynchronous metadata set from the specified address using the specified download mode.

GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
GetWebRequest(Uri, String, String)

Gdy jest zastępowany w klasie pochodnej, zwraca HttpWebRequest używany do przesyłania żądań HTTP/GET metadanych.When overridden in a derived class, returns the HttpWebRequest used to make HTTP/GET metadata requests.

MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Dotyczy