ServiceDescription ServiceDescription ServiceDescription ServiceDescription Class

Definition

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.Provides a means of creating and formatting a valid Web Services Description Language (WSDL) document file, complete with appropriate namespaces, elements, and attributes, for describing an XML Web service. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

public ref class ServiceDescription sealed : System::Web::Services::Description::NamedItem
[System.Web.Services.Configuration.XmlFormatExtensionPoint("Extensions")]
public sealed class ServiceDescription : System.Web.Services.Description.NamedItem
type ServiceDescription = class
    inherit NamedItem
Public NotInheritable Class ServiceDescription
Inherits NamedItem
Vererbung
ServiceDescriptionServiceDescriptionServiceDescriptionServiceDescription
Attribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie eine Instanz der ServiceDescription-Klasse erstellt wird.The following example shows how to create an instance of the ServiceDescription class.

// 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 mit der statischen Read -Methode erstellt werden, die eine WSDL-Datei analysiert und deren Werte den entsprechenden Membern der Klasse zuweist.Instances of this class can be created with either the new keyword or the static Read method, which parses a WSDL file and assigns its values to appropriate members of the class.

WSDL ist eine XML-basierte Sprache zum Beschreiben von XML-Webdiensten.WSDL is an XML-based language for describing XML Web services. Die ServiceDescription -Klasse entspricht dem root- definitionsElement einer WSDL-Datei.The ServiceDescription class corresponds to the root element, definitions, of a WSDL file. Weitere Informationen zu WSDL finden Sie in der WSDL-Spezifikation.For more information about WSDL, see the WSDL specification.

Konstruktoren

ServiceDescription() ServiceDescription() ServiceDescription() ServiceDescription()

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

Felder

Namespace Namespace Namespace Namespace

Der XML-Namespace, in dem die ServiceDescription-Klasse definiert wird („http://schemas.xmlsoap.org/wsdl/“).The XML namespace in which the ServiceDescription class is defined ("http://schemas.xmlsoap.org/wsdl/"). Dieses Feld ist konstant.This field is constant.

Eigenschaften

Bindings Bindings Bindings Bindings

Ruft die Auflistung von Binding-Elementen ab, die in der ServiceDescription enthalten sind.Gets the collection of Binding elements contained in the ServiceDescription.

Documentation Documentation Documentation Documentation

Ruft die Textdokumentation für die Instanz von DocumentableItem ab oder legt diese fest.Gets or sets the text documentation for the instance of the DocumentableItem.

(Inherited from DocumentableItem)
DocumentationElement DocumentationElement DocumentationElement DocumentationElement

Ruft das Dokumentationselement für das DocumentableItem ab oder legt dieses fest.Gets or sets the documentation element for the DocumentableItem.

(Inherited from DocumentableItem)
ExtensibleAttributes ExtensibleAttributes ExtensibleAttributes 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.Gets or sets an array of type XmlAttribute that represents attribute extensions of WSDL to comply with Web Services Interoperability (WS-I) Basic Profile 1.1.

(Inherited from DocumentableItem)
Extensions Extensions Extensions Extensions

Ruft die Auflistung von Erweiterbarkeitselementen ab, die in der ServiceDescription enthalten sind.Gets the collection of extensibility elements contained in the ServiceDescription.

Imports Imports Imports Imports

Ruft die Auflistung von Import-Elementen ab, die in der ServiceDescription enthalten sind.Gets the collection of Import elements contained in the ServiceDescription.

Messages Messages Messages Messages

Ruft die Auflistung von Message-Elementen ab, die in der ServiceDescription enthalten sind.Gets the collection of Message elements contained in the ServiceDescription.

Name Name Name Name

Ruft das XML-Namensattribut des descriptions-Tags ab, das die WSDL-Datei (Web Services Description Language) einschließt, oder legt dieses fest.Gets or sets the XML name attribute of the descriptions tag enclosing the Web Services Description Language (WSDL) file.

Namespaces Namespaces Namespaces 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.Gets or sets the dictionary of namespace prefixes and namespaces used to preserve namespace prefixes and namespaces when a ServiceDescription object is constructed.

(Inherited from DocumentableItem)
PortTypes PortTypes PortTypes PortTypes

Ruft die Auflistung von PortType-Elementen ab, die in der ServiceDescription enthalten sind.Gets the collection of PortType elements contained in the ServiceDescription.

RetrievalUrl RetrievalUrl RetrievalUrl RetrievalUrl

Ruft die URL des XML-Webdiensts ab, auf den die ServiceDescription-Instanz angewendet wird, oder legt diese URL fest.Gets or sets the URL of the XML Web service to which the ServiceDescription instance applies.

Schema Schema Schema Schema

Ruft das Schema ab, das dieser ServiceDescription zugeordnet ist.Gets the schema associated with this ServiceDescription.

Serializer Serializer Serializer Serializer

Ruft das zum Serialisieren und Deserialisieren eines ServiceDescription-Objekts in ein oder aus einem WSDL-Dokument (Web Services Description Language) verwendete Serialisierungsprogramm ab.Gets the XML serializer used to serialize and deserialize between a ServiceDescription object and a Web Services Description Language (WSDL) document.

ServiceDescriptions ServiceDescriptions ServiceDescriptions ServiceDescriptions

Ruft die ServiceDescriptionCollection-Instanz ab, zu deren Membern ServiceDescription gehört.Gets the ServiceDescriptionCollection instance of which the ServiceDescription is a member.

Services Services Services Services

Ruft die Auflistung von Service-Instanzen ab, die in der ServiceDescription enthalten sind.Gets the collection of Service instances contained in the ServiceDescription.

TargetNamespace TargetNamespace TargetNamespace TargetNamespace

Ruft das XML-targetNamespace-Attribut des descriptions-Tags ab, das eine WSDL (Web Services Description Language)-Datei einschließt, oder legt dieses fest.Gets or sets the XML targetNamespace attribute of the descriptions tag enclosing a Web Services Description Language (WSDL) file.

Types Types Types Types

Ruft eine Instanz von Types ab, die in ServiceDescription enthalten sind, oder legt diese fest.Gets or sets the Types contained by the ServiceDescription.

ValidationWarnings ValidationWarnings ValidationWarnings 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.Gets a StringCollection that contains any validation warnings that were generated during a call to Read(Stream, Boolean), Read(TextReader, Boolean), Read(String, Boolean), or Read(XmlReader, Boolean) with the validate parameter set to true.

Methoden

CanRead(XmlReader) CanRead(XmlReader) CanRead(XmlReader) 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.Gets a value that indicates whether an XmlReader represents a valid Web Services Description Language (WSDL) file that can be parsed.

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)
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)
Read(Stream) Read(Stream) Read(Stream) Read(Stream)

Initialisiert eine Instanz der ServiceDescription-Klasse, indem die XML-Daten direkt aus einer Stream-Instanz geladen werden.Initializes an instance of the ServiceDescription class by directly loading the XML from a Stream instance.

Read(Stream, Boolean) Read(Stream, Boolean) Read(Stream, Boolean) Read(Stream, Boolean)

Initialisiert eine Instanz der ServiceDescription-Klasse, indem die XML-Daten direkt aus einer Stream-Instanz geladen werden.Initializes an instance of the ServiceDescription class by directly loading the XML from a Stream instance.

Read(String) Read(String) Read(String) Read(String)

Initialisiert eine Instanz eines ServiceDescription-Objekts, indem die XML-Daten direkt aus der angegebenen Datei geladen werden.Initializes an instance of a ServiceDescription object by directly loading the XML from the specified file.

Read(String, Boolean) Read(String, Boolean) Read(String, Boolean) Read(String, Boolean)

Initialisiert eine Instanz eines ServiceDescription-Objekts, indem die XML-Daten direkt aus der angegebenen Datei geladen werden.Initializes an instance of a ServiceDescription object by directly loading the XML from the specified file.

Read(TextReader) Read(TextReader) Read(TextReader) Read(TextReader)

Initialisiert eine Instanz der ServiceDescription-Klasse, indem die XML-Daten direkt aus einem TextReader geladen werden.Initializes an instance of the ServiceDescription class by directly loading the XML from a TextReader.

Read(TextReader, Boolean) Read(TextReader, Boolean) Read(TextReader, Boolean) Read(TextReader, Boolean)

Initialisiert eine Instanz der ServiceDescription-Klasse, indem die XML-Daten direkt aus einem TextReader geladen werden.Initializes an instance of the ServiceDescription class by directly loading the XML from a TextReader.

Read(XmlReader) Read(XmlReader) Read(XmlReader) Read(XmlReader)

Initialisiert eine Instanz der ServiceDescription-Klasse, indem die XML-Daten direkt aus einem XmlReader geladen werden.Initializes an instance of the ServiceDescription class by directly loading the XML from an XmlReader.

Read(XmlReader, Boolean) Read(XmlReader, Boolean) Read(XmlReader, Boolean) Read(XmlReader, Boolean)

Initialisiert eine Instanz der ServiceDescription-Klasse, indem die XML-Daten direkt aus einem XmlReader geladen werden.Initializes an instance of the ServiceDescription class by directly loading the XML from an XmlReader.

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)
Write(Stream) Write(Stream) Write(Stream) Write(Stream)

Schreibt die ServiceDescription in den angegebenen Stream.Writes out the ServiceDescription to the specified Stream.

Write(String) Write(String) Write(String) Write(String)

Schreibt die ServiceDescription als WSDL-Datei (Web Services Description Language) in den angegebenen Pfad.Writes out the ServiceDescription as a Web Services Description Language (WSDL) file to the specified path.

Write(TextWriter) Write(TextWriter) Write(TextWriter) Write(TextWriter)

Schreibt die ServiceDescription als WSDL-Datei (Web Services Description Language) in den TextWriter.Writes out the ServiceDescription as a Web Services Description Language (WSDL) file to the TextWriter.

Write(XmlWriter) Write(XmlWriter) Write(XmlWriter) Write(XmlWriter)

Schreibt die ServiceDescription als WSDL-Datei (Web Services Description Language) in den XmlWriter.Writes out the ServiceDescription to the XmlWriter as a Web Services Description Language (WSDL) file.

Gilt für: