ServiceDescription Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- Héritage
- 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 |
| 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 |
| 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 |
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). |