ServiceDescription Classe

Définition

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

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
Héritage
ServiceDescription
Héritage
ServiceDescription
Attributs

Exemples

L’exemple suivant montre comment créer une instance de la ServiceDescription classe.

// 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 pour décrire les services Web XML. La ServiceDescription classe correspond à l’élément racine, definitionsd’un fichier WSDL. Pour plus d’informations sur WSDL, consultez la spécification WSDL .

Constructeurs

Nom Description
ServiceDescription()

Initialise une nouvelle instance de la classe ServiceDescription.

Champs

Nom Description
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

Nom Description
Bindings

Obtient la collection d’éléments Binding contenus dans le ServiceDescription.

Documentation

Obtient ou définit la documentation textuelle de l’instance du DocumentableItem.

(Hérité de DocumentableItem)
DocumentationElement

Obtient ou définit l’élément de documentation pour le DocumentableItem.

(Hérité de DocumentableItem)
ExtensibleAttributes

Obtient ou définit un tableau de type XmlAttribute qui représente les extensions d’attribut de WSDL pour se conformer à l’interopérabilité des services Web (WS-I) Profil de base 1.1.

(Hérité de DocumentableItem)
Extensions

Obtient la collection d’éléments d’extensibilité contenus dans le ServiceDescription.

Imports

Obtient la collection d’éléments Import contenus dans le ServiceDescription.

Messages

Obtient la collection d’éléments Message contenus dans le ServiceDescription.

Name

Obtient ou définit l’attribut de nom XML de la descriptions balise englobant le fichier WSDL (Web Services Description Language).

Name

Obtient ou définit le nom de l’élément.

(Hérité de NamedItem)
Namespaces

Obtient ou définit le dictionnaire des préfixes d’espace de noms et des espaces de noms utilisés pour conserver les préfixes et les espaces de noms d’espace de noms lorsqu’un ServiceDescription objet est construit.

(Hérité de DocumentableItem)
PortTypes

Obtient la collection d’éléments PortType contenus dans le ServiceDescription.

RetrievalUrl

Obtient ou définit l’URL du service Web XML auquel l’instance ServiceDescription s’applique.

Schema

Obtient le schéma associé à ce ServiceDescription.

Serializer

Obtient le sérialiseur XML utilisé pour sérialiser et désérialiser entre un ServiceDescription objet et un document WSDL (Web Services Description Language).

ServiceDescriptions

Obtient l’instance ServiceDescriptionCollection dont le ServiceDescription membre est membre.

Services

Obtient la collection d’instances Service contenues dans le ServiceDescription.

TargetNamespace

Obtient ou définit l’attribut XML targetNamespace de la descriptions balise englobant un fichier WSDL (Web Services Description Language).

Types

Obtient ou définit le Types contenu par le ServiceDescription.

ValidationWarnings

Obtient un StringCollection qui contient tous les avertissements de validation générés pendant un appel à Read(Stream, Boolean), Read(TextReader, Boolean)ou Read(XmlReader, Boolean)Read(String, Boolean)avec le validate paramètre défini sur true.

Méthodes

Nom Description
CanRead(XmlReader)

Obtient une valeur qui indique si un XmlReader fichier WSDL (Web Services Description Language) valide peut être analysé.

Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
Read(Stream, Boolean)

Initialise une instance de la ServiceDescription classe en chargeant directement le code XML à partir d’une Stream instance.

Read(Stream)

Initialise une instance de la ServiceDescription classe en chargeant directement le code XML à partir d’une Stream instance.

Read(String, Boolean)

Initialise une instance d’un ServiceDescription objet en chargeant directement le code XML à partir du fichier spécifié.

Read(String)

Initialise une instance d’un ServiceDescription objet en chargeant directement le code XML à partir du fichier spécifié.

Read(TextReader, Boolean)

Initialise une instance de la ServiceDescription classe en chargeant directement le code XML à partir d’un TextReader.

Read(TextReader)

Initialise une instance de la ServiceDescription classe en chargeant directement le code XML à partir d’un TextReader.

Read(XmlReader, Boolean)

Initialise une instance de la ServiceDescription classe en chargeant directement le code XML à partir d’un XmlReader.

Read(XmlReader)

Initialise une instance de la ServiceDescription classe en chargeant directement le code XML à partir d’un XmlReader.

ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)
Write(Stream)

Écrit le ServiceDescription fichier dans le fichier spécifié Stream.

Write(String)

Écrit le ServiceDescription fichier WSDL (Web Services Description Language) dans le chemin d’accès spécifié.

Write(TextWriter)

Écrit le ServiceDescription fichier WSDL (Web Services Description Language) dans le TextWriterfichier .

Write(XmlWriter)

Écrit dans ServiceDescription le XmlWriter fichier WSDL (Web Services Description Language).

S’applique à