MetadataExchangeClient Classe

Riferimento

Definizione

Spazio dei nomi:: System.ServiceModel.Description

Assembly:: System.ServiceModel.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Scarica i metadati del servizio.

public ref class MetadataExchangeClient

public class MetadataExchangeClient

type MetadataExchangeClient = class

Public Class MetadataExchangeClient

Ereditarietà: Object
MetadataExchangeClient

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare MetadataExchangeClient per specificare un'associazione di scaricamento, risolvere i riferimenti contenuti ai metadati e scaricare i metadati.

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

Commenti

Utilizzare MetadataExchangeClient per scaricare i metadati. In genere, un elemento MetadataExchangeClient viene configurato per una richiesta di metadati e viene quindi passato al metodo MetadataResolver.Resolve o MetadataResolver.Resolve affinché venga utilizzato da MetadataResolver per scaricare i metadati.

È tuttavia possibile utilizzare l'elemento MetadataExchangeClient direttamente per recuperare i metadati come MetadataSet contenente oggetti MetadataSection.

Che venga utilizzato direttamente o passato a un elemento MetadataResolver, MetadataExchangeClient dispone dei membri seguenti per il controllo del processo di download dei metadati:

Utilizzare i costruttori per personalizzare l'associazione da utilizzare nella richiesta dei metadati.
Utilizzare la proprietà HttpCredentials per specificare le credenziali utilizzate per eseguire una richiesta HTTP/GET.
Utilizzare la proprietà SoapCredentials per specificare le credenziali utilizzate per eseguire una richiesta di metadati WS-Transfer.
Utilizzare la proprietà MaximumResolvedReferences per limitare il numero di riferimenti ai metadati risolti dall'elemento MetadataExchangeClient.
Utilizzare la proprietà OperationTimeout per limitare il tempo impiegato nel recupero dei metadati.
Utilizzare la proprietà ResolveMetadataReferences per specificare se individuare e recuperare altri documenti di metadati ai quali fanno riferimento i metadati scaricati dall'endpoint dei metadati originale.
Utilizzare i metodi GetMetadata per avviare il processo di download.

È inoltre possibile creare una classe derivata in grado di eseguire l'override dei due metodi protetti seguenti:

Eseguire l'override del metodo GetChannelFactory per modificare il canale che esegue una richiesta di metadati utilizzando WS-Transfer.
Eseguire l'override del metodo GetWebRequest per modificare l'elemento HttpWebRequest che esegue una richiesta di metadati utilizzando HTTP/GET.

Costruttori

MetadataExchangeClient()	Inizializza una nuova istanza della classe MetadataExchangeClient.
MetadataExchangeClient(Binding)	Inizializza una nuova istanza della classe MetadataExchangeClient utilizzando l'associazione specificata.
MetadataExchangeClient(EndpointAddress)	Inizializza una nuova istanza della classe MetadataExchangeClient.
MetadataExchangeClient(String)	Inizializza una nuova istanza della classe MetadataExchangeClient.
MetadataExchangeClient(Uri, MetadataExchangeClientMode)	Inizializza una nuova istanza della classe MetadataExchangeClient.

Proprietà

HttpCredentials	Ottiene o imposta le credenziali utilizzate per eseguire la richiesta HTTP/GET.
MaximumResolvedReferences	Ottiene o imposta il numero massimo di riferimenti ai metadati scaricati da MetadataExchangeClient.
OperationTimeout	Ottiene o imposta il tempo di completamento del download dei metadati, scaduto il quale viene generata un'eccezione.
ResolveMetadataReferences	Ottiene o imposta un valore che controlla se i riferimenti ai metadati sono risolti.
SoapCredentials	Ottiene o imposta le credenziali di sicurezza del client utilizzate per eseguire una richiesta di metadati WS-Transfer.

Metodi

BeginGetMetadata(AsyncCallback, Object)	Avvia una chiamata asincrona che restituisce un oggetto MetadataSet.
BeginGetMetadata(EndpointAddress, AsyncCallback, Object)	Avvia una chiamata asincrona che restituisce un oggetto MetadataSet utilizzando l'indirizzo, il callback e lo stato asincrono specificati.
BeginGetMetadata(Uri, MetadataExchangeClientMode, AsyncCallback, Object)	Avvia una chiamata asincrona che restituisce un oggetto MetadataSet utilizzando l'indirizzo, il callback, lo stato asincrono e il meccanismo di download specificati.
EndGetMetadata(IAsyncResult)	Termina una chiamata asincrona che restituisce un oggetto MetadataSet.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetChannelFactory(EndpointAddress, String, String)	Quando viene sottoposto a override in una classe derivata, restituisce il channel factory utilizzato per eseguire la richiesta di metadati WS-Transfer.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetMetadata()	Restituisce un valore MetadataSet.
GetMetadata(EndpointAddress)	Restituisce un elemento MetadataSet dall'indirizzo specificato.
GetMetadata(EndpointAddress, Uri)	Restituisce un elemento MetadataSet dall'indirizzo specificato e nella route specificata.
GetMetadata(Uri, MetadataExchangeClientMode)	Restituisce un elemento MetadataSet dall'indirizzo specificato utilizzando la modalità di download indicata.
GetMetadataAsync()	Restituisce un set di metadati asincroni.
GetMetadataAsync(EndpointAddress)	Restituisce un set di metadati asincroni dall'indirizzo specificato.
GetMetadataAsync(EndpointAddress, Uri)	Restituisce un set di metadati asincroni dall'indirizzo specificato e sulla route specificata.
GetMetadataAsync(Uri, MetadataExchangeClientMode)	Restituisce un set di metadati asincroni dall'indirizzo specificato utilizzando la modalità di download specificata.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetWebRequest(Uri, String, String)	Quando viene sottoposto a override in una classe derivata, restituisce l'elemento HttpWebRequest utilizzato per eseguire richieste di metadati HTTP/GET.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Si applica a

Condividi tramite