MetadataExporter Classe

Définition

Espace de noms:

System.ServiceModel.Description

Assembly:

System.ServiceModel.dll

Exporte les informations sur la description du service dans des métadonnées.

public ref class MetadataExporter abstract

public abstract class MetadataExporter

type MetadataExporter = class

Public MustInherit Class MetadataExporter

Héritage

Object

MetadataExporter

Dérivé

System.ServiceModel.Description.WsdlExporter

Exemples

L'exemple de code suivant est une méthode IWsdlExportExtension.ExportContract qui met en œuvre l'utilisation de la propriété State de la classe WsdlExporter pour attacher un objet System.Runtime.Serialization.XsdDataContractExporter personnalisé afin de modifier l'exportation de contrats de données dans le point de terminaison.

public void ExportContract(WsdlExporter exporter, WsdlContractConversionContext context)
{

// Add a custom DCAnnotationSurrogate to write data contract comments into the XSD.
object dataContractExporter;
XsdDataContractExporter xsdDCExporter;
if (!exporter.State.TryGetValue(typeof(XsdDataContractExporter), out dataContractExporter))
{
    xsdDCExporter = new XsdDataContractExporter(exporter.GeneratedXmlSchemas);
    exporter.State.Add(typeof(XsdDataContractExporter), xsdDCExporter);
}
else
{
    xsdDCExporter = (XsdDataContractExporter)dataContractExporter;
}

if (xsdDCExporter.Options == null)
    xsdDCExporter.Options = new ExportOptions();
xsdDCExporter.Options.DataContractSurrogate = new DCAnnotationSurrogate();

Remarques

L'exportation de métadonnées est le processus permettant de décrire les points de terminaison du service et de les projeter dans une représentation parallèle standardisée (généralement XML, mais pas obligatoirement) que les applications peuvent exploiter pour implémenter un client qui utilise le service. Pour exporter des métadonnées issues d'objets System.ServiceModel.Description.ServiceEndpoint, passez par une implémentation de la classe abstraite MetadataExporter. Une implémentation MetadataExporter génère des métadonnées encapsulée dans une instance System.ServiceModel.Description.MetadataSet.

La classe MetadataExporter fournit une infrastructure permettant de générer des expressions de stratégie qui décrivent les fonctions et les spécifications d'une liaison de point de terminaison et ses opérations, messages et erreurs associés. Ces expressions de stratégie sont capturées dans une instance System.ServiceModel.Description.PolicyConversionContext. Une implémentation MetadataExporter peut ensuite attacher ces expressions de stratégie aux métadonnées qu'elle génère.

MetadataExporter appelle chaque System.ServiceModel.Channels.BindingElement qui implémente l'interface System.ServiceModel.Description.IPolicyExportExtension dans la liaison d'un ServiceEndpoint lors de la génération d'un objet PolicyConversionContext devant être utilisé par l'implémentation MetadataExporter. Vous pouvez exporter de nouvelles assertions de stratégie en implémentant l'interface IPolicyExportExtension sur vos implémentations personnalisées du type System.ServiceModel.Channels.BindingElement.

Le System.ServiceModel.Description.WsdlExporter type est l’implémentation de la MetadataExporter classe incluse dans Windows Communication Foundation (WCF). Le type WsdlExporter génère les métadonnées WSDL avec les expressions de stratégie jointes.

Pour exporter des métadonnées WSDL ou des extensions WSDL personnalisées pour les comportements de point de terminaison, les comportements de contrat ou les éléments de liaison d'un point de terminaison de service, vous pouvez implémenter l'interface System.ServiceModel.Description.IWsdlExportExtension. Le type WsdlExporter appelle les parties d'un point de terminaison de service qui implémentent cette interface lors de la génération du document WSDL à partir de ce point de terminaison.

Propriétés

Errors	Obtient une collection des erreurs qui se sont produites lors de l’exportation de métadonnées.
PolicyVersion	Spécifie la version de spécification WS-Policy utilisée.
State	Obtient un dictionnaire d'objets utilisés lors de l'exportation de métadonnées.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
ExportContract(ContractDescription)	En cas de substitution dans une classe dérivée, exporte une description de contrat dans des métadonnées.
ExportEndpoint(ServiceEndpoint)	En cas de substitution dans une classe dérivée, convertit un point de terminaison en métadonnées.
ExportPolicy(ServiceEndpoint)	Convertit des assertions de stratégie en objet PolicyConversionContext.
GetGeneratedMetadata()	En cas de substitution dans une classe dérivée, retourne les métadonnées générées par un appel de ExportContract(ContractDescription), ExportEndpoint(ServiceEndpoint) ou ExportPolicy(ServiceEndpoint).
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
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)