ServiceDescription Clase

Definición

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::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
Herencia
ServiceDescription
Herencia
ServiceDescription
Atributos

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 atributo de nombre XML de la descriptions etiqueta que incluye el archivo WSDL (Lenguaje de descripción de servicios web).

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

Se aplica a