MetadataExporter Klasse

Definition

public ref class MetadataExporter abstract

public abstract class MetadataExporter

type MetadataExporter = class

Public MustInherit Class MetadataExporter

Vererbung

Object

MetadataExporter

Abgeleitet

System.ServiceModel.Description.WsdlExporter

Beispiele

Folgendes Codebeispiel stellt eine IWsdlExportExtension.ExportContract-Methode dar, die veranschaulicht, wie mit der State-Eigenschaft der Klasse WsdlExporter ein benutzerdefiniertes System.Runtime.Serialization.XsdDataContractExporter angefügt wird, das den Export von Datenverträgen in den Endpunkt ändert.

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

Hinweise

Metadatenexport ist der Prozess der Beschreibung von Dienstendpunkten und ihrer Projektion in eine parallele, standardisierte Darstellung (in der Regel, jedoch nicht notwendigerweise XML). Auf diese kann von Anwendungen zur Implementierung eines Clients, der diesen Dienst verwendet, zugegriffen werden. Mit einer Implementierung der abstrakten System.ServiceModel.Description.ServiceEndpoint-Klasse können Sie Metadaten aus MetadataExporter-Objekten exportieren. Eine MetadataExporter-Implementierung generiert Metadaten, die in einer System.ServiceModel.Description.MetadataSet-Instanz gekapselt werden.

Die MetadataExporter-Klasse stellt ein Framework für die Generierung von Richtlinienausdrücken bereit, welche die Fähigkeiten und Anforderungen einer Endpunktbindung und die zugehörigen Vorgänge, Meldungen und Fehler beschreiben. Diese Richtlinienausdrücke werden in einer System.ServiceModel.Description.PolicyConversionContext-Instanz aufgezeichnet. Eine MetadataExporter-Implementierung kann diese Richtlinienausdrücke dann an die von ihr generierten Metadaten anfügen.

Der MetadataExporter ruft jedes System.ServiceModel.Channels.BindingElement-Objekt auf, das die System.ServiceModel.Description.IPolicyExportExtension-Schnittstelle in der Bindung eines ServiceEndpoint implementiert, wenn ein PolicyConversionContext-Objekt für die zu verwendende MetadataExporter-Implementierung erzeugt wird. Sie können neue Richtlinienassertionen exportieren, indem Sie die IPolicyExportExtension-Schnittstelle in Ihren benutzerdefinierten Implementierungen des System.ServiceModel.Channels.BindingElement-Typs implementieren.

Der System.ServiceModel.Description.WsdlExporter Typ ist die Implementierung der Klasse, die MetadataExporter in Windows Communication Foundation (WCF) enthalten ist. Der WsdlExporter-Typ generiert WSDL-Metadaten mit angefügten Richtlinienausdrücken.

Um benutzerdefinierte WSDL-Metadaten oder WSDL-Erweiterungen für Endpunktverhalten, Vertragsverhalten oder Bindungselemente in einem Dienstendpunkt zu exportieren, können Sie die System.ServiceModel.Description.IWsdlExportExtension-Schnittstelle implementieren. Der WsdlExporter-Typ ruft Teile eines Dienstendpunkts auf, die diese Schnittstelle implementieren, wenn das WSDL-Dokument anhand dieses Endpunkts erstellt wird.

Eigenschaften

Methoden

Gilt für: