WsdlExporter WsdlExporter WsdlExporter WsdlExporter Class

Definition

Wandelt Dienst-, Vertrags- und Endpunktinformationen in Metadatendokumente um.Converts service, contract, and endpoint information into metadata documents.

public ref class WsdlExporter : System::ServiceModel::Description::MetadataExporter
public class WsdlExporter : System.ServiceModel.Description.MetadataExporter
type WsdlExporter = class
    inherit MetadataExporter
Public Class WsdlExporter
Inherits MetadataExporter
Vererbung

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die ExportEndpoint-Methode zum Generieren von MetadataSection-Objekten aus den Endpunkten in einer Auflistung von ServiceEndpoint-Objekten verwendet wird, die als myServiceEndpoints bezeichnet werden.The following code example shows how to use the ExportEndpoint method to generate a set of MetadataSection objects from the endpoints in a collection of ServiceEndpoint objects called myServiceEndpoints.

using System;
using System.ServiceModel;
using System.ServiceModel.Description;

namespace WsdlExporterSample
{
    class Program
    {
        static void Main(string[] args)
        {
            WsdlExporter exporter = new WsdlExporter();
            exporter.PolicyVersion = PolicyVersion.Policy15;
          
            ServiceEndpoint [] myServiceEndpoints = new ServiceEndpoint[2];
            ContractDescription myDescription = new ContractDescription ("myContract");
            myServiceEndpoints[0] = new ServiceEndpoint(myDescription,new BasicHttpBinding(),new EndpointAddress("http://localhost/myservice"));
            myServiceEndpoints[1] = new ServiceEndpoint(myDescription,new BasicHttpBinding(),new EndpointAddress("http://localhost/myservice"));
            
            // Export all endpoints for each endpoint in collection.
            foreach (ServiceEndpoint endpoint in myServiceEndpoints)
            {
                exporter.ExportEndpoint(endpoint);
            }
            // If there are no errors, get the documents.
            MetadataSet metadataDocs = null;
            if (exporter.Errors.Count != 0)
            {
                metadataDocs = exporter.GetGeneratedMetadata();
            }
        }
    }
}
Imports System
Imports System.ServiceModel
Imports System.ServiceModel.Description

Module Module1

    Sub Main()
        Dim exporter As New WsdlExporter()
        exporter.PolicyVersion = PolicyVersion.Policy15

        Dim myServiceEndpoints() As ServiceEndpoint = New ServiceEndpoint(1) {}
        Dim myDescription As New ContractDescription("myContract")
        myServiceEndpoints(0) = New ServiceEndpoint(myDescription, New BasicHttpBinding(), New EndpointAddress("http://localhost/myservice"))
        myServiceEndpoints(1) = New ServiceEndpoint(myDescription, New BasicHttpBinding(), New EndpointAddress("http://localhost/myservice"))

        'Export all endpoints for each endpoint in collection.
        For Each endpoint As ServiceEndpoint In myServiceEndpoints
            exporter.ExportEndpoint(endpoint)
        Next

        'If there are no errors, get the documents.
        Dim metadataDocs As MetadataSet
        metadataDocs = Nothing

        If (exporter.Errors.Count = 0) Then
            metadataDocs = exporter.GetGeneratedMetadata()
        End If
    End Sub

End Module

Hinweise

Verwenden Sie die WsdlExporter-Klasse, um ContractDescription-Objekte oder ServiceEndpoint-Objekte in Metadaten zu transformieren, die durch MetadataSection-Objekte dargestellt werden.Use the WsdlExporter class to transform ContractDescription or ServiceEndpoint objects into metadata represented by MetadataSection objects.

Der WsdlExporter wird in einem dreistufigen Prozess verwendet.The WsdlExporter is used in a three-step process.

  1. Rufen Sie die Methode ExportContract, ExportEndpoint oder ExportEndpoints auf, und übergeben Sie die entsprechenden Parameter.Call the ExportContract, ExportEndpoint, or ExportEndpoints method, passing the appropriate parameters.

  2. Bestimmen Sie, ob Exportfehler aufgetreten sind, indem Sie die Basis-Errors-Eigenschaft prüfen.Determine whether there are any export errors by checking the base Errors property.

  3. Wenn keine Fehler vorliegen, können Sie GetGeneratedMetadata zum Abrufen einer Auflistung von MetadataSection-Objekten verwenden oder spezifischere Versionen der Metadaten mit der GeneratedWsdlDocuments-Eigenschaft oder GeneratedXmlSchemas-Eigenschaft abrufen.If there are no errors, use the GetGeneratedMetadata to get a collection of MetadataSection objects or get more specific versions of the metadata using the GeneratedWsdlDocuments or GeneratedXmlSchemas properties.

Sie können eine Unterstützung für den Export benutzerdefinierter WSDL-Erweiterungen einrichten, indem Sie die IWsdlExportExtension-Schnittstelle implementieren, sowie eine Unterstützung für benutzerdefinierte Richtlinienassertionen, indem Sie die IPolicyExportExtension-Schnittstelle implementieren.You can support exporting custom WSDL extensions by implementing the IWsdlExportExtension interface and custom policy assertions by implementing the IPolicyExportExtension interface. Weitere Informationen finden Sie in der Dokumentation zu diesen Schnittstellen.For details, see the documentation for those interfaces.

Hinweis

WsdlExporter kann nur zum Exportieren von Metadaten von ContractDescription-Instanzen verwendet werden, die Common Language Runtime (CLR)-Typinformationen enthalten, wie z. B. eine ContractDescription-Instanz, die mit der ContractDescription.GetContract-Methode oder als Teil der ServiceDescription für eine ServiceHost-Instanz erstellt wurde.The WsdlExporter can only be used to export metadata from ContractDescription instances that contain Common Language Runtime (CLR) type information, such as a ContractDescription instance created using the ContractDescription.GetContract method or created as part of the ServiceDescription for a ServiceHost instance. Sie können WsdlExporter nicht zum Exportieren von Metadaten aus ContractDescription-Instanzen verwenden, die aus Dienstmetadaten stammen oder ohne Typinformationen erstellt wurden.You cannot use the WsdlExporter to export metadata from ContractDescription instances imported from service metadata or constructed without type information.

Konstruktoren

WsdlExporter() WsdlExporter() WsdlExporter() WsdlExporter()

Initialisiert eine neue Instanz der WsdlExporter-Klasse.Initializes a new instance of the WsdlExporter class.

Eigenschaften

Errors Errors Errors Errors

Ruft eine Auflistung von Fehlern ab, die während des Metadatenexports aufgetreten sind.Gets a collection of errors that occurred during metadata export.

(Inherited from MetadataExporter)
GeneratedWsdlDocuments GeneratedWsdlDocuments GeneratedWsdlDocuments GeneratedWsdlDocuments

Ruft eine Auflistung von ServiceDescription-Objekten auf, nachdem eine der Exportmethoden aufgerufen wurde.Gets a collection of ServiceDescription objects after calling one of the export methods.

GeneratedXmlSchemas GeneratedXmlSchemas GeneratedXmlSchemas GeneratedXmlSchemas

Ruft eine Auflistung von XmlSchema-Objekten ab, nachdem eine der Exportmethoden aufgerufen wurde.Gets a set of XmlSchema objects after calling one of the export methods.

PolicyVersion PolicyVersion PolicyVersion PolicyVersion

Gibt die Version der verwendeten WS-Richtlinienspezifikation an.Specifies the version of WS-Policy specification being used.

(Inherited from MetadataExporter)
State State State State

Ruft ein Wörterbuch mit den im Export der Metadaten verwendeten Objekten ab.Gets a dictionary of objects used in the export of metadata.

(Inherited from MetadataExporter)

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExportContract(ContractDescription) ExportContract(ContractDescription) ExportContract(ContractDescription) ExportContract(ContractDescription)

Exportiert Metadaten, in denen nur die Vertragsinformationen aus der angegebenen Vertragsbeschreibung beschrieben werden.Exports metadata that describes only the contract information from the specified contract description.

ExportEndpoint(ServiceEndpoint) ExportEndpoint(ServiceEndpoint) ExportEndpoint(ServiceEndpoint) ExportEndpoint(ServiceEndpoint)

Generiert Metadaten zum angegebenen Endpunkt.Generates metadata about the specified endpoint.

ExportEndpoints(IEnumerable<ServiceEndpoint>, XmlQualifiedName) ExportEndpoints(IEnumerable<ServiceEndpoint>, XmlQualifiedName) ExportEndpoints(IEnumerable<ServiceEndpoint>, XmlQualifiedName) ExportEndpoints(IEnumerable<ServiceEndpoint>, XmlQualifiedName)

Generiert Metadaten zu einer Gruppe von Endpunkten von einem angegebenen Dienst.Generates metadata about a group of endpoints from a specified service.

ExportPolicy(ServiceEndpoint) ExportPolicy(ServiceEndpoint) ExportPolicy(ServiceEndpoint) ExportPolicy(ServiceEndpoint)

Konvertiert Richtlinienassertionen in ein PolicyConversionContext-Objekt.Converts policy assertions into a PolicyConversionContext object.

(Inherited from MetadataExporter)
GetGeneratedMetadata() GetGeneratedMetadata() GetGeneratedMetadata() GetGeneratedMetadata()

Gibt eine aufzählbare Auflistung generierter MetadataSection-Objekte zurück.Returns an enumerable collection of generated MetadataSection objects.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für: