ServiceDescription Classe

Definizione

Spazio dei nomi:

System.Web.Services.Description

Assembly:

System.Web.Services.dll

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::NamedItem

[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 NamedItem

Public NotInheritable Class ServiceDescription
Inherits NamedItem

Ereditarietà

Object

DocumentableItem

NamedItem

ServiceDescription

Attributi

XmlFormatExtensionPointAttribute

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