Partager via


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

S’applique à