MetadataExchangeClient Classe

Définition

Espace de noms:

System.ServiceModel.Description

Assembly:

System.ServiceModel.dll

Télécharge les métadonnées du service.

public ref class MetadataExchangeClient

public class MetadataExchangeClient

type MetadataExchangeClient = class

Public Class MetadataExchangeClient

Héritage

Object

MetadataExchangeClient

Exemples

L'exemple de code suivant illustre l'utilisation de MetadataExchangeClient pour spécifier une liaison de téléchargement, résoudre toutes les références aux métadonnées incluses et télécharger les métadonnées.

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

Remarques

Utilisez MetadataExchangeClient pour télécharger les métadonnées. En règle générale, MetadataExchangeClient est configuré pour une demande de métadonnées avant d'être passé à la méthode MetadataResolver.Resolve ou MetadataResolver.Resolve pour le MetadataResolver à utiliser pour télécharger les métadonnées.

Toutefois, vous pouvez utiliser directement MetadataExchangeClient pour récupérer les métadonnées en tant que MetadataSet qui contient des objets MetadataSection.

En cas d'utilisation directe ou de passage à MetadataResolver, MetadataExchangeClient contient les membres suivants pour contrôler le processus de téléchargement des métadonnées :

• Utilisez les constructeurs pour personnaliser la liaison à utiliser lors de la demande de métadonnées.

• Utilisez la propriété HttpCredentials pour spécifier les informations d'identification utilisées pour effectuer une requête HTTP/GET.

• Utilisez la propriété SoapCredentials pour spécifier les informations d'identification utilisées pour effectuer une demande de métadonnées WS-Transfer.

• Utilisez la propriété MaximumResolvedReferences pour limiter le nombre de références de métadonnées résolues par MetadataExchangeClient.

• Utilisez la propriété OperationTimeout pour limiter le temps consacré à la récupération des métadonnées.

• Utilisez la propriété ResolveMetadataReferences pour localiser et récupérer d'autres documents de métadonnées référencés par les métadonnées téléchargées du point de terminaison de métadonnées d'origine.

• Utilisez les méthodes GetMetadata pour démarrer le processus de téléchargement.

De plus, vous pouvez créer une classe dérivée qui peut substituer les deux méthodes protégées suivantes :

• Substituer la méthode GetChannelFactory pour modifier le canal qui effectue une demande de métadonnées à l'aide de WS-Transfer.

• Substituer la méthode GetWebRequest pour modifier le HttpWebRequest qui effectue une demande de métadonnées à l'aide de HTTP/GET.

Constructeurs

MetadataExchangeClient()	Initialise une nouvelle instance de la classe MetadataExchangeClient.
MetadataExchangeClient(Binding)	Initialise une nouvelle instance de la classe MetadataExchangeClient à l’aide de la liaison spécifiée.
MetadataExchangeClient(EndpointAddress)	Initialise une nouvelle instance de la classe MetadataExchangeClient.
MetadataExchangeClient(String)	Initialise une nouvelle instance de la classe MetadataExchangeClient.
MetadataExchangeClient(Uri, MetadataExchangeClientMode)	Initialise une nouvelle instance de la classe MetadataExchangeClient.

Propriétés

HttpCredentials	Obtient ou définit les informations d'identification utilisées pour effectuer une requête HTTP/GET.
MaximumResolvedReferences	Obtient ou définit le nombre maximal de références à des métadonnées téléchargées par MetadataExchangeClient.
OperationTimeout	Obtient ou définit la période pendant laquelle les métadonnées doivent être téléchargées avant qu'une exception ne soit levée.
ResolveMetadataReferences	Obtient ou définit une valeur qui détermine si les références aux métadonnées sont résolues.
SoapCredentials	Obtient ou définit les informations d'identification de sécurité du client utilisées pour effectuer une demande de métadonnées WS-Transfer.

Méthodes

BeginGetMetadata(AsyncCallback, Object)	Commence un appel de méthode asynchrone qui retourne MetadataSet.
BeginGetMetadata(EndpointAddress, AsyncCallback, Object)	Commence un appel de méthode asynchrone qui retourne MetadataSet à l'aide de l'adresse, du rappel et de l'état asynchrone spécifiés.
BeginGetMetadata(Uri, MetadataExchangeClientMode, AsyncCallback, Object)	Commence un appel de méthode asynchrone qui retourne MetadataSet à l'aide de l'adresse, du rappel, de l'état asynchrone et du mécanisme de téléchargement spécifiés.
EndGetMetadata(IAsyncResult)	Termine un appel de méthode asynchrone qui retourne MetadataSet.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetChannelFactory(EndpointAddress, String, String)	En cas de substitution dans une classe dérivée, retourne la fabrique de canal utilisée pour effectuer la demande de métadonnées WS-Transfer.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetMetadata()	Retourne MetadataSet.
GetMetadata(EndpointAddress)	Retourne MetadataSet à partir de l'adresse spécifiée.
GetMetadata(EndpointAddress, Uri)	Retourne MetadataSet à partir de l'adresse spécifiée et via l'itinéraire spécifié.
GetMetadata(Uri, MetadataExchangeClientMode)	Retourne MetadataSet à partir de l'adresse spécifiée à l'aide du mode de téléchargement spécifié.
GetMetadataAsync()	Retourne les métadonnées asynchrones définies.
GetMetadataAsync(EndpointAddress)	Retourne les métadonnées asynchrones définies à partir de l'adresse spécifiée.
GetMetadataAsync(EndpointAddress, Uri)	Retourne les métadonnées asynchrones définies à partir de l'adresse spécifiée et sur l'itinéraire spécifié.
GetMetadataAsync(Uri, MetadataExchangeClientMode)	Retourne les métadonnées asynchrones définies à partir de l'adresse spécifiée à l'aide du mode de téléchargement spécifié.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
GetWebRequest(Uri, String, String)	En cas de substitution dans une classe dérivée, retourne le HttpWebRequest utilisé pour effectuer les demandes de métadonnées HTTP/GET.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)