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. La classe non può essere ereditata.

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.

// 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

Le istanze di questa classe possono essere create con la new parola chiave o il metodo statico Read , che analizza un file WSDL e assegna i relativi valori ai membri appropriati della classe.

WSDL è un linguaggio basato su XML per descrivere i servizi Web XML. La ServiceDescription classe corrisponde all'elemento radice, definitions, di un file WSDL. Per altre informazioni su WSDL, vedere la specifica WSDL.

Costruttori

ServiceDescription()

Inizializza una nuova istanza della classe ServiceDescription.

Campi

Namespace

Spazio dei nomi XML in cui viene definita la ServiceDescription classe ("http://schemas.xmlsoap.org/wsdl/"). Questo campo è costante.

Proprietà

Bindings

Ottiene l'insieme degli elementi Binding contenuti in ServiceDescription.

Documentation

Ottiene o imposta la documentazione di testo per l'istanza di DocumentableItem.

(Ereditato da DocumentableItem)
DocumentationElement

Ottiene o imposta l'elemento di documentazione di 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.

(Ereditato da DocumentableItem)
Extensions

Ottiene l'insieme degli elementi di estensibilità contenuti in ServiceDescription.

Imports

Ottiene l'insieme degli elementi Import contenuti in ServiceDescription.

Messages

Ottiene l'insieme degli elementi Message contenuti in ServiceDescription.

Name

Ottiene o imposta l'attributo del nome XML del descriptions tag che racchiude il file WSDL (Web Services Description Language).

Name

Ottiene o imposta il nome dell'elemento.

(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.

(Ereditato da DocumentableItem)
PortTypes

Ottiene l'insieme degli elementi PortType contenuti in ServiceDescription.

RetrievalUrl

Ottiene o imposta l'URL del servizio Web XML a cui si applica l'istanza di ServiceDescription.

Schema

Ottiene lo schema associato a questo oggetto ServiceDescription.

Serializer

Ottiene il serializzatore XML utilizzato per serializzare e deserializzare tra un oggetto ServiceDescription e un documento WSDL.

ServiceDescriptions

Ottiene l'istanza di ServiceDescriptionCollection di cui ServiceDescription è membro.

Services

Ottiene l'insieme delle istanze di Service contenute in 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).

Types

Ottiene o imposta l'oggetto Types contenuto dall'oggetto 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.

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.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
Read(Stream, Boolean)

Inizializza un'istanza della classe ServiceDescription caricando il codice XML direttamente da un'istanza di Stream.

Read(Stream)

Inizializza un'istanza della classe ServiceDescription caricando il codice XML direttamente da un'istanza di Stream.

Read(String, Boolean)

Inizializza un'istanza di un oggetto ServiceDescription caricando il codice XML direttamente dal file specificato.

Read(String)

Inizializza un'istanza di un oggetto ServiceDescription caricando il codice XML direttamente dal file specificato.

Read(TextReader, Boolean)

Inizializza un'istanza della classe ServiceDescription caricando il codice XML direttamente da un oggetto TextReader.

Read(TextReader)

Inizializza un'istanza della classe ServiceDescription caricando il codice XML direttamente da un oggetto TextReader.

Read(XmlReader, Boolean)

Inizializza un'istanza della classe ServiceDescription caricando il codice XML direttamente da un oggetto XmlReader.

Read(XmlReader)

Inizializza un'istanza della classe ServiceDescription caricando il codice XML direttamente da un oggetto XmlReader.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
Write(Stream)

Scrive l'oggetto ServiceDescription nell'oggetto Stream specificato.

Write(String)

Scrive l'oggetto ServiceDescription come file del linguaggio di descrizione dei servizi Web (WSDL, Web Services Description Language) nel percorso specificato.

Write(TextWriter)

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

Write(XmlWriter)

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

Si applica a