MetadataExporter Klasse

Referenz

Definition

Namespace:: System.ServiceModel.Description

Assembly:: System.ServiceModel.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Exportiert Dienstbeschreibungsinformationen in Metadaten.

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

Errors	Ruft eine Auflistung von Fehlern ab, die während des Metadatenexports aufgetreten sind.
PolicyVersion	Gibt die Version der verwendeten WS-Richtlinienspezifikation an.
State	Ruft ein Wörterbuch mit den im Export der Metadaten verwendeten Objekten ab.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
ExportContract(ContractDescription)	Exportiert beim Überschreiben in einer abgeleiteten Klasse eine Vertragsbeschreibung in Metadaten.
ExportEndpoint(ServiceEndpoint)	Konvertiert bei Überschreibung in einer abgeleiteten Klasse einen Endpunkt in Metadaten.
ExportPolicy(ServiceEndpoint)	Konvertiert Richtlinienassertionen in ein PolicyConversionContext-Objekt.
GetGeneratedMetadata()	Gibt bei Überschreibung in einer abgeleiteten Klasse die durch einen Aufruf von ExportContract(ContractDescription), ExportEndpoint(ServiceEndpoint) oder ExportPolicy(ServiceEndpoint) erzeugten Metadaten zurück.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für:

Freigeben über