ServiceDescription Clase

Definición

Proporciona un medio para crear y dar formato a un archivo de documento válido del lenguaje de descripción de servicios web (WSDL), que se completa con los espacios de nombres, elementos y atributos adecuados, para describir 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 crear una instancia de la ServiceDescription clase .

// 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, , definitionsde un archivo WSDL. Para obtener más información sobre WSDL, consulte la especificación WSDL .

Constructores

Nombre Description
ServiceDescription()

Inicializa una nueva instancia de la clase ServiceDescription.

Campos

Nombre Description
Namespace

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

Propiedades

Nombre Description
Bindings

Obtiene la colección de Binding elementos contenidos 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 de DocumentableItem.

(Heredado de DocumentableItem)
ExtensibleAttributes

Obtiene o establece una matriz de tipo XmlAttribute que representa las extensiones de atributo de WSDL para cumplir con la interoperabilidad de servicios web (WS-I) Perfil básico 1.1.

(Heredado de DocumentableItem)
Extensions

Obtiene la colección de elementos de extensibilidad contenidos en .ServiceDescription

Imports

Obtiene la colección de Import elementos contenidos en .ServiceDescription

Messages

Obtiene la colección de Message elementos contenidos en .ServiceDescription

Name

Obtiene o establece el atributo de nombre XML de la descriptions etiqueta que incluye el archivo del lenguaje de descripción de servicios web (WSDL).

Name

Obtiene o establece el nombre del elemento.

(Heredado de NamedItem)
Namespaces

Obtiene o establece el diccionario de prefijos de espacio de nombres y espacios de nombres usados para conservar los prefijos de espacio de nombres y los espacios de nombres cuando se construye un ServiceDescription objeto.

(Heredado de DocumentableItem)
PortTypes

Obtiene la colección de PortType elementos contenidos en .ServiceDescription

RetrievalUrl

Obtiene o establece la dirección URL del servicio web XML al que se aplica la ServiceDescription instancia.

Schema

Obtiene el esquema asociado a este ServiceDescriptionobjeto .

Serializer

Obtiene el serializador XML usado para serializar y deserializar entre un ServiceDescription objeto y un documento de lenguaje de descripción de servicios web (WSDL).

ServiceDescriptions

Obtiene la ServiceDescriptionCollection instancia de la que ServiceDescription es miembro.

Services

Obtiene la colección de Service instancias contenidas en .ServiceDescription

TargetNamespace

Obtiene o establece el atributo XML targetNamespace de la descriptions etiqueta que incluye un archivo de lenguaje de descripción de servicios web (WSDL).

Types

Obtiene o establece el Types contenido de .ServiceDescription

ValidationWarnings

Obtiene un StringCollection objeto que contiene las advertencias de validación que se generaron durante una llamada a Read(Stream, Boolean), Read(TextReader, Boolean), Read(String, Boolean)o Read(XmlReader, Boolean) con el validate parámetro establecido en true.

Métodos

Nombre Description
CanRead(XmlReader)

Obtiene un valor que indica si XmlReader representa un archivo válido del lenguaje de descripción de servicios web (WSDL) que se puede analizar.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
GetHashCode()

Actúa como función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
Read(Stream, Boolean)

Inicializa una instancia de la ServiceDescription clase cargando directamente el XML desde una Stream instancia de .

Read(Stream)

Inicializa una instancia de la ServiceDescription clase cargando directamente el XML desde una Stream instancia de .

Read(String, Boolean)

Inicializa una instancia de un ServiceDescription objeto cargando directamente el XML desde el archivo especificado.

Read(String)

Inicializa una instancia de un ServiceDescription objeto cargando directamente el XML desde el archivo especificado.

Read(TextReader, Boolean)

Inicializa una instancia de la ServiceDescription clase cargando directamente el XML desde un TextReader.

Read(TextReader)

Inicializa una instancia de la ServiceDescription clase cargando directamente el XML desde un TextReader.

Read(XmlReader, Boolean)

Inicializa una instancia de la ServiceDescription clase cargando directamente el XML desde un XmlReader.

Read(XmlReader)

Inicializa una instancia de la ServiceDescription clase cargando directamente el XML desde un XmlReader.

ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
Write(Stream)

Escribe en ServiceDescription el objeto especificado Stream.

Write(String)

Escribe como ServiceDescription un archivo de lenguaje de descripción de servicios web (WSDL) en la ruta de acceso especificada.

Write(TextWriter)

Escribe como ServiceDescription un archivo de lenguaje de descripción de servicios web (WSDL) en .TextWriter

Write(XmlWriter)

Escribe en como ServiceDescriptionXmlWriter un archivo de lenguaje de descripción de servicios web (WSDL).

Se aplica a