ServiceDescription Clase

Definición

Espacio de nombres:

System.Web.Services.Description

Ensamblado:

System.Web.Services.dll

Proporciona un medio de crear y asignar formato a un archivo documental WSDL (Lenguaje de descripción de servicios Web) válido, con los espacios de nombres, elementos y atributos correspondientes, para la descripción de un servicio Web XML. Esta clase no puede heredarse.

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

Herencia

Object

DocumentableItem

NamedItem

ServiceDescription

Atributos

XmlFormatExtensionPointAttribute

Ejemplos

En el ejemplo siguiente se muestra cómo se crea una instancia de la clase 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")

Comentarios

Las instancias de esta clase se pueden crear con la new palabra clave o el método estático Read , que analiza un archivo WSDL y asigna sus valores a los miembros adecuados de la clase.

WSDL es un lenguaje basado en XML para describir servicios web XML. La ServiceDescription clase corresponde al elemento raíz, definitions, de un archivo WSDL. Para obtener más información sobre WSDL, consulte la especificación WSDL.

Constructores

ServiceDescription()

Inicializa una nueva instancia de la clase ServiceDescription.

Campos

Namespace

Espacio de nombres XML en el que se define la ServiceDescription clase ("http://schemas.xmlsoap.org/wsdl/"). Este campo es constante.

Propiedades

Bindings	Obtiene la colección de los elementos Binding incluidos en ServiceDescription.
Documentation	Obtiene o establece la documentación de texto de la instancia de DocumentableItem. (Heredado de DocumentableItem)
DocumentationElement	Obtiene o establece el elemento de documentación para el objeto DocumentableItem. (Heredado de DocumentableItem)
ExtensibleAttributes	Obtiene o establece una matriz de tipo XmlAttribute que representa extensiones de atributo de WSDL que se ajustan al perfil básico de interoperabilidad de los servicios Web (WS-I) 1.1. (Heredado de DocumentableItem)
Extensions	Obtiene la colección de los elementos de extensibilidad incluidos en ServiceDescription.
Imports	Obtiene la colección de los elementos Import incluidos en ServiceDescription.
Messages	Obtiene la colección de los elementos Message incluidos en ServiceDescription.
Name	Obtiene o establece el nombre del elemento. (Heredado de NamedItem)
Namespaces	Obtiene o establece el diccionario de prefijos de espacio de nombres y los espacios de nombres utilizados para conservar los prefijos de espacio de nombres y los espacios de nombres cuando se construye un objeto ServiceDescription. (Heredado de DocumentableItem)
PortTypes	Obtiene la colección de los elementos PortType incluidos en ServiceDescription.
RetrievalUrl	Obtiene o establece la dirección URL del servicio Web XML al que se aplica la instancia de ServiceDescription.
Schema	Obtiene el esquema asociado a este ServiceDescription.
Serializer	Obtiene el serializador XML utilizado para serializar y deserializar entre un objeto ServiceDescription y un documento WSDL (Lenguaje de descripción de servicios Web).
ServiceDescriptions	Obtiene la instancia de ServiceDescriptionCollection de la que forma parte ServiceDescription.
Services	Obtiene la colección de instancias de Service incluidas en ServiceDescription.
TargetNamespace	Obtiene o establece el atributo targetNamespace XML de la etiqueta descriptions que contiene un archivo WSDL (Lenguaje de descripción de servicios Web).
Types	Obtiene o establece el objeto Types incluido en ServiceDescription.
ValidationWarnings	Obtiene un objeto StringCollection que contiene las advertencias de validación generadas durante una llamada a los métodos Read(Stream, Boolean), Read(TextReader, Boolean), Read(String, Boolean) o Read(XmlReader, Boolean) con el parámetro validate establecido en true.

Métodos

CanRead(XmlReader)	Obtiene un valor que indica si un objeto XmlReader representa un archivo WSDL (Lenguaje de descripción de servicios Web) válido que se pueda analizar.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Read(Stream, Boolean)	Inicializa una instancia de la clase ServiceDescription cargando directamente el XML de una instancia de Stream.
Read(Stream)	Inicializa una instancia de la clase ServiceDescription cargando directamente el XML de una instancia de Stream.
Read(String, Boolean)	Inicializa una instancia de un objeto ServiceDescription cargando directamente el XML del archivo especificado.
Read(String)	Inicializa una instancia de un objeto ServiceDescription cargando directamente el XML del archivo especificado.
Read(TextReader, Boolean)	Inicializa una instancia de la clase ServiceDescription cargando directamente el XML desde TextReader.
Read(TextReader)	Inicializa una instancia de la clase ServiceDescription cargando directamente el XML desde TextReader.
Read(XmlReader, Boolean)	Inicializa una instancia de la clase ServiceDescription cargando directamente el XML de un XmlReader.
Read(XmlReader)	Inicializa una instancia de la clase ServiceDescription cargando directamente el XML de un XmlReader.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
Write(Stream)	Escribe el ServiceDescription en el Stream especificado.
Write(String)	Escribe el ServiceDescription como un archivo WSDL (Lenguaje de descripción de servicios Web) en la ruta de acceso especificada.
Write(TextWriter)	Escribe el ServiceDescription como un archivo WSDL (Lenguaje de descripción de servicios Web) en TextWriter.
Write(XmlWriter)	Escribe el ServiceDescription en XmlWriter como un archivo WSDL (Lenguaje de descripción de servicios Web).