ServiceDescription Klasse

Referenz

Definition

Namespace:: System.Web.Services.Description

Assembly:: System.Web.Services.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.

Bietet eine Möglichkeit zum Erstellen und Formatieren einer gültigen WSDL-Dokumentdatei (Web Services Description Language-Dokumentdatei) mit den entsprechenden Namespaces, Elementen und Attributen zur Beschreibung eines XML-Webdiensts. Diese Klasse kann nicht vererbt werden.

public ref class ServiceDescription sealed : System::Web::Services::Description::DocumentableItem

public ref class ServiceDescription sealed : System::Web::Services::Description::NamedItem

[System.Web.Services.Configuration.XmlFormatExtensionPoint("Extensions")]
public sealed class ServiceDescription : System.Web.Services.Description.DocumentableItem

[System.Web.Services.Configuration.XmlFormatExtensionPoint("Extensions")]
public sealed class ServiceDescription : System.Web.Services.Description.NamedItem

[<System.Web.Services.Configuration.XmlFormatExtensionPoint("Extensions")>]
type ServiceDescription = class
    inherit DocumentableItem

[<System.Web.Services.Configuration.XmlFormatExtensionPoint("Extensions")>]
type ServiceDescription = class
    inherit NamedItem

Public NotInheritable Class ServiceDescription
Inherits DocumentableItem

Public NotInheritable Class ServiceDescription
Inherits NamedItem

Vererbung: Object

DocumentableItem
ServiceDescription

Vererbung: Object

DocumentableItem

NamedItem
ServiceDescription

Attribute: XmlFormatExtensionPointAttribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie eine Instanz der ServiceDescription-Klasse erstellt wird.

// Obtain the ServiceDescription of existing Wsdl.
ServiceDescription^ myDescription = ServiceDescription::Read( "MyWsdl_CS.wsdl" );

// Remove the Binding from the Binding Collection of ServiceDescription.
BindingCollection^ myBindingCollection = myDescription->Bindings;
myBindingCollection->Remove( myBindingCollection[ 0 ] );

// Form a new Binding.
Binding^ myBinding = gcnew Binding;
myBinding->Name = "Service1Soap";
XmlQualifiedName^ myXmlQualifiedName = gcnew XmlQualifiedName( "s0:Service1Soap" );
myBinding->Type = myXmlQualifiedName;
SoapBinding^ mySoapBinding = gcnew SoapBinding;
mySoapBinding->Transport = "http://schemas.xmlsoap.org/soap/http";
mySoapBinding->Style = SoapBindingStyle::Document;
OperationBinding^ addOperationBinding = CreateOperationBinding( "Add", myDescription->TargetNamespace );
myBinding->Operations->Add( addOperationBinding );
myBinding->Extensions->Add( mySoapBinding );

// Add the Binding to the ServiceDescription.
myDescription->Bindings->Add( myBinding );
myDescription->Write( "MyOutWsdl.wsdl" );

// Obtain the ServiceDescription of existing Wsdl.
ServiceDescription myDescription = ServiceDescription.Read("MyWsdl_CS.wsdl");
// Remove the Binding from the Binding Collection of ServiceDescription.
BindingCollection myBindingCollection = myDescription.Bindings;
myBindingCollection.Remove(myBindingCollection[0]);

// Form a new Binding.
Binding myBinding = new Binding();
myBinding.Name = "Service1Soap";
XmlQualifiedName myXmlQualifiedName =
                     new XmlQualifiedName("s0:Service1Soap");
myBinding.Type = myXmlQualifiedName;

SoapBinding mySoapBinding = new SoapBinding();
mySoapBinding.Transport = "http://schemas.xmlsoap.org/soap/http";
mySoapBinding.Style = SoapBindingStyle.Document;

OperationBinding addOperationBinding =
       CreateOperationBinding("Add",myDescription.TargetNamespace);
myBinding.Operations.Add(addOperationBinding);
myBinding.Extensions.Add(mySoapBinding);

// Add the Binding to the ServiceDescription.
myDescription.Bindings.Add(myBinding);
myDescription.Write("MyOutWsdl.wsdl");

' Obtain the ServiceDescription of existing Wsdl.
Dim myDescription As ServiceDescription = ServiceDescription.Read("MyWsdl_VB.wsdl")
' Remove the Binding from the Binding Collection of ServiceDescription.
Dim myBindingCollection As BindingCollection = myDescription.Bindings
myBindingCollection.Remove(myBindingCollection(0))

' Form a new Binding.
Dim myBinding As New Binding()
myBinding.Name = "Service1Soap"
Dim myXmlQualifiedName As New XmlQualifiedName("s0:Service1Soap")
myBinding.Type = myXmlQualifiedName

Dim mySoapBinding As New SoapBinding()
mySoapBinding.Transport = "http://schemas.xmlsoap.org/soap/http"
mySoapBinding.Style = SoapBindingStyle.Document

Dim addOperationBinding As OperationBinding = CreateOperationBinding("Add", _
                                             myDescription.TargetNamespace)
myBinding.Operations.Add(addOperationBinding)
myBinding.Extensions.Add(mySoapBinding)

' Add the Binding to the ServiceDescription.
myDescription.Bindings.Add(myBinding)
myDescription.Write("MyOutWsdl.wsdl")

Hinweise

Instanzen dieser Klasse können entweder mit dem new Schlüsselwort oder der statischen Read Methode erstellt werden, die eine WSDL-Datei analysiert und seine Werte den entsprechenden Mitgliedern der Klasse zuweisen.

WSDL ist eine XML-basierte Sprache zum Beschreiben von XML-Webdiensten. Die ServiceDescription Klasse entspricht dem Stammelement, definitionsder WSDL-Datei. Weitere Informationen zu WSDL finden Sie in der WSDL-Spezifikation.

Konstruktoren

ServiceDescription()

Initialisiert eine neue Instanz der ServiceDescription-Klasse.

Felder

Namespace

Der XML-Namespace, in dem die ServiceDescription-Klasse definiert wird („http://schemas.xmlsoap.org/wsdl/“). Dieses Feld ist konstant.

Eigenschaften

Bindings	Ruft die Auflistung von Binding-Elementen ab, die in der ServiceDescription enthalten sind.
Documentation	Ruft die Textdokumentation für die Instanz von DocumentableItem ab oder legt diese fest. (Geerbt von DocumentableItem)
DocumentationElement	Ruft das Dokumentationselement für das DocumentableItem ab oder legt dieses fest. (Geerbt von DocumentableItem)
ExtensibleAttributes	Ruft ein Array vom Typ XmlAttribute ab, das Attributerweiterungen von WSDL darstellt, um dem WS-I-Basisprofil 1.1 (Web Services Interoperability) zu entsprechen, oder legt dieses fest. (Geerbt von DocumentableItem)
Extensions	Ruft die Auflistung von Erweiterbarkeitselementen ab, die in der ServiceDescription enthalten sind.
Imports	Ruft die Auflistung von Import-Elementen ab, die in der ServiceDescription enthalten sind.
Messages	Ruft die Auflistung von Message-Elementen ab, die in der ServiceDescription enthalten sind.
Name	Ruft das XML-Namensattribut des `descriptions`-Tags ab, das die WSDL-Datei (Web Services Description Language) einschließt, oder legt dieses fest.
Name	Ruft den Namen des Elements ab oder legt diesen fest. (Geerbt von NamedItem)
Namespaces	Ruft das Wörterbuch der Namespacepräfixe und Namespaces ab, die verwendet werden, um die Namespacepräfixe und Namespaces beim Erstellen eines ServiceDescription-Objekts beizubehalten. (Geerbt von DocumentableItem)
PortTypes	Ruft die Auflistung von PortType-Elementen ab, die in der ServiceDescription enthalten sind.
RetrievalUrl	Ruft die URL des XML-Webdiensts ab, auf den die ServiceDescription-Instanz angewendet wird, oder legt diese URL fest.
Schema	Ruft das Schema ab, das dieser ServiceDescription zugeordnet ist.
Serializer	Ruft das zum Serialisieren und Deserialisieren eines ServiceDescription-Objekts in ein oder aus einem WSDL-Dokument (Web Services Description Language) verwendete Serialisierungsprogramm ab.
ServiceDescriptions	Ruft die ServiceDescriptionCollection-Instanz ab, zu deren Membern ServiceDescription gehört.
Services	Ruft die Auflistung von Service-Instanzen ab, die in der ServiceDescription enthalten sind.
TargetNamespace	Ruft das XML-`targetNamespace`-Attribut des `descriptions`-Tags ab, das eine WSDL (Web Services Description Language)-Datei einschließt, oder legt dieses fest.
Types	Ruft eine Instanz von Types ab, die in ServiceDescription enthalten sind, oder legt diese fest.
ValidationWarnings	Ruft eine StringCollection ab, die alle bei Aufrufen von Read(Stream, Boolean), Read(TextReader, Boolean), Read(String, Boolean) oder Read(XmlReader, Boolean) mit auf `true` festgelegtem `validate`-Parameter generierten Validierungswarnungen enthält.

Methoden

CanRead(XmlReader)	Ruft einen Wert ab, der angibt, ob ein XmlReader eine gültige WSDL-Datei (Web Services Description Language) darstellt, die analysiert werden kann.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
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)
Read(Stream)	Initialisiert eine Instanz der ServiceDescription-Klasse, indem die XML-Daten direkt aus einer Stream-Instanz geladen werden.
Read(Stream, Boolean)	Initialisiert eine Instanz der ServiceDescription-Klasse, indem die XML-Daten direkt aus einer Stream-Instanz geladen werden.
Read(String)	Initialisiert eine Instanz eines ServiceDescription-Objekts, indem die XML-Daten direkt aus der angegebenen Datei geladen werden.
Read(String, Boolean)	Initialisiert eine Instanz eines ServiceDescription-Objekts, indem die XML-Daten direkt aus der angegebenen Datei geladen werden.
Read(TextReader)	Initialisiert eine Instanz der ServiceDescription-Klasse, indem die XML-Daten direkt aus einem TextReader geladen werden.
Read(TextReader, Boolean)	Initialisiert eine Instanz der ServiceDescription-Klasse, indem die XML-Daten direkt aus einem TextReader geladen werden.
Read(XmlReader)	Initialisiert eine Instanz der ServiceDescription-Klasse, indem die XML-Daten direkt aus einem XmlReader geladen werden.
Read(XmlReader, Boolean)	Initialisiert eine Instanz der ServiceDescription-Klasse, indem die XML-Daten direkt aus einem XmlReader geladen werden.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
Write(Stream)	Schreibt die ServiceDescription in den angegebenen Stream.
Write(String)	Schreibt die ServiceDescription als WSDL-Datei (Web Services Description Language) in den angegebenen Pfad.
Write(TextWriter)	Schreibt die ServiceDescription als WSDL-Datei (Web Services Description Language) in den TextWriter.
Write(XmlWriter)	Schreibt die ServiceDescription als WSDL-Datei (Web Services Description Language) in den XmlWriter.

Gilt für