ServiceDescription Classe

Definizione

Fornisce un sistema per creare e formattare un file di documento del linguaggio di descrizione dei servizi Web (WSDL, Web Services Description Language) valido, completo di spazi dei nomi, elementi e attributi appropriati, per la descrizione di un servizio Web XML.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. La classe non può essere ereditata.This class cannot be inherited.

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
Ereditarietà
ServiceDescription
Ereditarietà
ServiceDescription
Attributi

Esempio

Nell'esempio seguente viene illustrato come creare un'istanza della classe ServiceDescription.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")

Commenti

È possibile creare istanze di questa classe con la new parola chiave o il Read metodo statico, che analizza un file WSDL e assegna i relativi valori ai membri appropriati della classe.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 è un linguaggio basato su XML per la descrizione dei servizi Web XML.WSDL is an XML-based language for describing XML Web services. La ServiceDescription classe corrisponde all'elemento radice, definitions , di un file WSDL.The ServiceDescription class corresponds to the root element, definitions, of a WSDL file. Per altre informazioni su WSDL, vedere la specifica WSDL.For more information about WSDL, see the WSDL specification.

Costruttori

ServiceDescription()

Inizializza una nuova istanza della classe ServiceDescription.Initializes a new instance of the ServiceDescription class.

Campi

Namespace

Spazio dei nomi XML in cui è definita la classe ServiceDescription ("http://schemas.xmlsoap.org/wsdl/").The XML namespace in which the ServiceDescription class is defined ("http://schemas.xmlsoap.org/wsdl/"). Questo campo è costante.This field is constant.

Proprietà

Bindings

Ottiene l'insieme degli elementi Binding contenuti in ServiceDescription.Gets the collection of Binding elements contained in the ServiceDescription.

Documentation

Ottiene o imposta la documentazione di testo per l'istanza di DocumentableItem.Gets or sets the text documentation for the instance of the DocumentableItem.

(Ereditato da DocumentableItem)
DocumentationElement

Ottiene o imposta l'elemento di documentazione di DocumentableItem.Gets or sets the documentation element for the DocumentableItem.

(Ereditato da DocumentableItem)
ExtensibleAttributes

Ottiene o imposta una matrice di tipo XmlAttribute che rappresenta le estensioni dell'attributo di WSDL per la conformità a Web Services Interoperability (WS-I) Basic Profile 1.1.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.

(Ereditato da DocumentableItem)
Extensions

Ottiene l'insieme degli elementi di estensibilità contenuti in ServiceDescription.Gets the collection of extensibility elements contained in the ServiceDescription.

Imports

Ottiene l'insieme degli elementi Import contenuti in ServiceDescription.Gets the collection of Import elements contained in the ServiceDescription.

Messages

Ottiene l'insieme degli elementi Message contenuti in ServiceDescription.Gets the collection of Message elements contained in the ServiceDescription.

Name

Ottiene o imposta l'attributo di nome XML del tag descriptions che racchiude un file WSDL (Web Services Description Language).Gets or sets the XML name attribute of the descriptions tag enclosing the Web Services Description Language (WSDL) file.

Name

Ottiene o imposta il nome dell'elemento.Gets or sets the name of the item.

(Ereditato da NamedItem)
Namespaces

Ottiene o imposta il dizionario dei prefissi degli spazi dei nomi e degli spazi dei nomi utilizzato per conservare i prefissi degli spazi dei nomi e gli spazi dei nomi quando viene costruito un oggetto ServiceDescription.Gets or sets the dictionary of namespace prefixes and namespaces used to preserve namespace prefixes and namespaces when a ServiceDescription object is constructed.

(Ereditato da DocumentableItem)
PortTypes

Ottiene l'insieme degli elementi PortType contenuti in ServiceDescription.Gets the collection of PortType elements contained in the ServiceDescription.

RetrievalUrl

Ottiene o imposta l'URL del servizio Web XML a cui si applica l'istanza di ServiceDescription.Gets or sets the URL of the XML Web service to which the ServiceDescription instance applies.

Schema

Ottiene lo schema associato a questo oggetto ServiceDescription.Gets the schema associated with this ServiceDescription.

Serializer

Ottiene il serializzatore XML utilizzato per serializzare e deserializzare tra un oggetto ServiceDescription e un documento WSDL.Gets the XML serializer used to serialize and deserialize between a ServiceDescription object and a Web Services Description Language (WSDL) document.

ServiceDescriptions

Ottiene l'istanza di ServiceDescriptionCollection di cui ServiceDescription è membro.Gets the ServiceDescriptionCollection instance of which the ServiceDescription is a member.

Services

Ottiene l'insieme delle istanze di Service contenute in ServiceDescription.Gets the collection of Service instances contained in the ServiceDescription.

TargetNamespace

Ottiene o imposta l'attributo XML targetNamespace del tag descriptions che racchiude un file del linguaggio di descrizione dei servizi Web (WSDL, Web Services Description Language).Gets or sets the XML targetNamespace attribute of the descriptions tag enclosing a Web Services Description Language (WSDL) file.

Types

Ottiene o imposta l'oggetto Types contenuto dall'oggetto ServiceDescription.Gets or sets the Types contained by the ServiceDescription.

ValidationWarnings

Ottiene un oggetto StringCollection contenente tutti gli avvisi di convalida generati durante una chiamata all'oggetto Read(Stream, Boolean), Read(TextReader, Boolean), Read(String, Boolean) o Read(XmlReader, Boolean) con il parametro validate impostato su true.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.

Metodi

CanRead(XmlReader)

Ottiene un valore che indica se un oggetto XmlReader rappresenta un file del linguaggio di descrizione dei servizi Web (WSDL, Web Services Description Language) valido che possa essere analizzato.Gets a value that indicates whether an XmlReader represents a valid Web Services Description Language (WSDL) file that can be parsed.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
Read(Stream)

Inizializza un'istanza della classe ServiceDescription caricando il codice XML direttamente da un'istanza di Stream.Initializes an instance of the ServiceDescription class by directly loading the XML from a Stream instance.

Read(Stream, Boolean)

Inizializza un'istanza della classe ServiceDescription caricando il codice XML direttamente da un'istanza di Stream.Initializes an instance of the ServiceDescription class by directly loading the XML from a Stream instance.

Read(String)

Inizializza un'istanza di un oggetto ServiceDescription caricando il codice XML direttamente dal file specificato.Initializes an instance of a ServiceDescription object by directly loading the XML from the specified file.

Read(String, Boolean)

Inizializza un'istanza di un oggetto ServiceDescription caricando il codice XML direttamente dal file specificato.Initializes an instance of a ServiceDescription object by directly loading the XML from the specified file.

Read(TextReader)

Inizializza un'istanza della classe ServiceDescription caricando il codice XML direttamente da un oggetto TextReader.Initializes an instance of the ServiceDescription class by directly loading the XML from a TextReader.

Read(TextReader, Boolean)

Inizializza un'istanza della classe ServiceDescription caricando il codice XML direttamente da un oggetto TextReader.Initializes an instance of the ServiceDescription class by directly loading the XML from a TextReader.

Read(XmlReader)

Inizializza un'istanza della classe ServiceDescription caricando il codice XML direttamente da un oggetto XmlReader.Initializes an instance of the ServiceDescription class by directly loading the XML from an XmlReader.

Read(XmlReader, Boolean)

Inizializza un'istanza della classe ServiceDescription caricando il codice XML direttamente da un oggetto XmlReader.Initializes an instance of the ServiceDescription class by directly loading the XML from an XmlReader.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
Write(Stream)

Scrive l'oggetto ServiceDescription nell'oggetto Stream specificato.Writes out the ServiceDescription to the specified Stream.

Write(String)

Scrive l'oggetto ServiceDescription come file del linguaggio di descrizione dei servizi Web (WSDL, Web Services Description Language) nel percorso specificato.Writes out the ServiceDescription as a Web Services Description Language (WSDL) file to the specified path.

Write(TextWriter)

Scrive l'oggetto ServiceDescription come file del linguaggio di descrizione dei servizi Web (WSDL, Web Services Description Language) in TextWriter.Writes out the ServiceDescription as a Web Services Description Language (WSDL) file to the TextWriter.

Write(XmlWriter)

Scrive l'oggetto ServiceDescription in XmlWriter come file del linguaggio di descrizione dei servizi Web (WSDL, Web Services Description Language).Writes out the ServiceDescription to the XmlWriter as a Web Services Description Language (WSDL) file.

Si applica a