MetadataExporter Klasse
Definition
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 abstractpublic abstract class MetadataExportertype MetadataExporter = classPublic MustInherit Class MetadataExporter- Vererbung
-
MetadataExporter
- Abgeleitet
Beispiele
Das folgende Codebeispiel ist eine IWsdlExportExtension.ExportContract Methode, die veranschaulicht, wie die State Eigenschaft der Klasse WsdlExporter verwendet wird, um einen Benutzerdefinierten System.Runtime.Serialization.XsdDataContractExporter anzufügen, der den Export von Datenverträgen im 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
Der Metadatenexport ist der Prozess der Beschreibung von Dienstendpunkten und das Projizieren in eine parallele, standardisierte Darstellung (in der Regel aber nicht unbedingt XML), auf die Anwendungen zugreifen können, um einen Client zu implementieren, der den Dienst verwendet. Verwenden Sie zum Exportieren von Metadaten aus System.ServiceModel.Description.ServiceEndpoint Objekten eine Implementierung der MetadataExporter abstrakten Klasse. Eine MetadataExporter Implementierung generiert Metadaten, die in einer System.ServiceModel.Description.MetadataSet Instanz gekapselt sind.
Die MetadataExporter Klasse bietet ein Framework zum Generieren von Richtlinienausdrücken, die die Funktionen und Anforderungen einer Endpunktbindung und der zugehörigen Vorgänge, Nachrichten 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 Richtlinien assertionen exportieren, indem Sie die IPolicyExportExtension Schnittstelle für Ihre 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 von diesem Endpunkt generiert wird.
Eigenschaften
| Name | Beschreibung |
|---|---|
| Errors |
Ruft eine Auflistung von Fehlern ab, die während des Metadatenexports aufgetreten sind. |
| PolicyVersion |
Gibt die Verwendete Version der WS-Policy Spezifikation an. |
| State |
Ruft ein Wörterbuch von Objekten ab, die im Export von Metadaten verwendet werden. |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| ExportContract(ContractDescription) |
Wenn eine abgeleitete Klasse überschrieben wird, wird eine Vertragsbeschreibung in Metadaten exportiert. |
| ExportEndpoint(ServiceEndpoint) |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, konvertiert ein Endpunkt in Metadaten. |
| ExportPolicy(ServiceEndpoint) |
Konvertiert Richtlinien assertionen in ein PolicyConversionContext Objekt. |
| GetGeneratedMetadata() |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, werden die metadaten zurückgegeben, die von einem Aufruf an entweder ExportContract(ContractDescription), oder ExportEndpoint(ServiceEndpoint)ExportPolicy(ServiceEndpoint). |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
