ServiceDescription Classe

Définition

Espace de noms:

System.Web.Services.Description

Assembly:

System.Web.Services.dll

Fournit un moyen de créer et de mettre en forme un fichier de document WSDL (Web Services Description Language) valide, complété des espaces de noms, des éléments et des attributs appropriés, pour la description d'un service Web XML. Cette classe ne peut pas être héritée.

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

Héritage

Object

DocumentableItem

NamedItem

ServiceDescription

Attributs

XmlFormatExtensionPointAttribute

Exemples

L'exemple suivant montre comment créer une instance de la 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")

Remarques

Les instances de cette classe peuvent être créées avec le new mot clé ou la méthode statique Read , qui analyse un fichier WSDL et affecte ses valeurs aux membres appropriés de la classe.

WSDL est un langage XML permettant de décrire les services Web XML. La ServiceDescription classe correspond à l’élément racine, definitions, d’un fichier WSDL. Pour plus d’informations sur WSDL, consultez la spécification WSDL.

Constructeurs

ServiceDescription()

Initialise une nouvelle instance de la classe ServiceDescription.

Champs

Namespace

Espace de noms XML dans lequel la ServiceDescription classe est définie («http://schemas.xmlsoap.org/wsdl/" ;). Ce champ est constant.

Propriétés

Bindings	Obtient la collection des éléments Binding contenus dans ServiceDescription.
Documentation	Obtient ou définit la documentation pour l'instance de DocumentableItem. (Hérité de DocumentableItem)
DocumentationElement	Obtient ou définit l'élément documentation pour DocumentableItem. (Hérité de DocumentableItem)
ExtensibleAttributes	Obtient ou définit un tableau de type XmlAttribute qui représente des extensions d'attribut de WSDL pour se conformer au Basic Profile 1.1 du WS-I (Web Services Interoperability). (Hérité de DocumentableItem)
Extensions	Obtient la collection des éléments d'extensibilité contenus dans ServiceDescription.
Imports	Obtient la collection des éléments Import contenus dans ServiceDescription.
Messages	Obtient la collection des éléments Message contenus dans ServiceDescription.
Name	Obtient ou définit le nom de l'élément. (Hérité de NamedItem)
Namespaces	Obtient ou définit le dictionnaire de préfixes d'espace de noms et d'espaces de noms utilisé pour conserver des préfixes d'espace de noms et des espaces de noms lorsqu'un objet ServiceDescription est construit. (Hérité de DocumentableItem)
PortTypes	Obtient la collection des éléments PortType contenus dans ServiceDescription.
RetrievalUrl	Obtient ou définit l'URL du service Web XML à laquelle l'instance de ServiceDescription s'applique.
Schema	Obtient le schéma associé à ServiceDescription.
Serializer	Obtient le sérialiseur XML utilisé pour effectuer une sérialisation et une désérialisation entre un objet ServiceDescription et un document WSDL (Web Services Description Language).
ServiceDescriptions	Obtient l'instance de ServiceDescriptionCollection dont ServiceDescription est membre.
Services	Obtient la collection des instances Service contenues dans ServiceDescription.
TargetNamespace	Obtient ou définit l'attribut targetNamespace XML de la balise descriptions encadrant un fichier WSDL (Web Services Description Language).
Types	Obtient ou définit le Types contenu par ServiceDescription.
ValidationWarnings	Obtient StringCollection contenant tous les avertissements de validation qui ont été générés pendant un appel à Read(Stream, Boolean), Read(TextReader, Boolean), Read(String, Boolean) ou Read(XmlReader, Boolean) avec la valeur true affectée au paramètre validate.

Méthodes

CanRead(XmlReader)	Obtient une valeur qui indique si XmlReader représente un fichier WSDL (Web Services Description Language) valide pouvant être analysé.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Read(Stream, Boolean)	Initialise une instance de la classe ServiceDescription en chargeant directement les données XML à partir d'une instance de Stream.
Read(Stream)	Initialise une instance de la classe ServiceDescription en chargeant directement les données XML à partir d'une instance de Stream.
Read(String, Boolean)	Initialise une instance d'un objet ServiceDescription en chargeant directement les données XML à partir du fichier spécifié.
Read(String)	Initialise une instance d'un objet ServiceDescription en chargeant directement les données XML à partir du fichier spécifié.
Read(TextReader, Boolean)	Initialise une instance de la classe ServiceDescription en chargeant directement les données XML à partir de TextReader.
Read(TextReader)	Initialise une instance de la classe ServiceDescription en chargeant directement les données XML à partir de TextReader.
Read(XmlReader, Boolean)	Initialise une instance de la classe ServiceDescription en chargeant directement les données XML à partir de XmlReader.
Read(XmlReader)	Initialise une instance de la classe ServiceDescription en chargeant directement les données XML à partir de XmlReader.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
Write(Stream)	Écrit ServiceDescription au Stream spécifié.
Write(String)	Écrit ServiceDescription en tant que fichier WSDL (Web Services Description Language) vers le chemin d'accès spécifié.
Write(TextWriter)	Écrit ServiceDescription en tant que fichier WSDL (Web Services Description Language) vers TextWriter.
Write(XmlWriter)	Écrit ServiceDescription vers XmlWriter en tant que fichier WSDL (Web Services Description Language).