ServiceDescription Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- Herencia
- 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 |
| 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 |
| 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 |
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). |