Herramienta Lenguaje de descripción de servicios Web (Wsdl.exe)
Esta herramienta genera código para servicios Web XML y clientes de servicios Web XML de ASP.NET a partir de archivos de contrato WSDL, esquemas XSD y documentos de descubrimiento (.discomap).
wsdl [options] {URL | path}
| Argumento | Descripción |
|---|---|
| URL | Dirección URL de un archivo de contrato WSDL (.wsdl), de un archivo de esquemas XSD (.xsd) o de un documento de descubrimiento (.disco). Hay que tener en cuenta que no se puede especificar una dirección URL de un documento de descubrimiento (.discomap). |
| path | Ruta de acceso a un archivo local de contrato WSDL (.wsdl), a un archivo de esquema XSD (.xsd) o a un documento de descubrimiento (.disco o .discomap). |
| Opción | Descripción |
|---|---|
| /appsettingurlkey:clave
o bien /urlkey:clave |
Especifica la clave de configuración que se utiliza para leer el valor predeterminado de la propiedad de la dirección URL cuando se genera código. |
| /appsettingbaseurl:URL base
o bien /baseurl:URL base |
Especifica la dirección URL base que se utiliza al calcular el fragmento de dirección URL. Esta herramienta calcula el fragmento de dirección URL convirtiendo la dirección URL relativa desde el argumento URL base en la dirección URL que contiene el documento WSDL. Se debe especificar la opción /appsettingurlkey con esta opción. |
| /d[omain]:dominio | Especifica el nombre del dominio que se utiliza para conectarse a un servidor que requiera autenticación. |
| /l[anguage]:lenguaje | Especifica el lenguaje que se utiliza para la clase proxy generada. Puede especificar CS (C#; valor predeterminado), VB (Visual Basic), JS (JScript) o VJS (Visual J#) como argumento de lenguaje. También se puede especificar el nombre completo de la clase que implementa System.CodeDom.Compiler.CodeDomProvider (Clase). |
| /n[amespace]:espacio de nombres | Especifica el espacio de nombres del proxy o plantilla generados. La opción predeterminada es el espacio de nombres global. |
| /nologo | Suprime la presentación de la portada de inicio de Microsoft. |
| /o[ut]:nombre de archivo | Especifica el archivo en el que se guarda el código proxy generado. La herramienta deriva el nombre de archivo predeterminado del nombre de servicio Web XML. La herramienta guarda los conjuntos de datos generados en varios archivos. |
| /parsableerrors | Muestra los errores en un formato similar al formato de los informes de errores que utilizan los compiladores de lenguajes. |
| /p[assword]:contraseña | Especifica la contraseña que se utiliza para conectarse a un servidor que requiera autenticación. |
| /protocol:protocolo | Especifica el protocolo que se implementa. Se puede especificar SOAP (el valor predeterminado), HttpGet, HttpPost o el protocolo personalizado que se especifique en el archivo de configuración. |
| /proxy:URL | Especifica la dirección URL del servidor proxy utilizada para las solicitudes HTTP. La opción predeterminada es que se utilice la configuración del sistema proxy. |
| /proxydomain:dominio
o bien /pd:dominio |
Especifica el dominio que se utiliza para conectarse a un servidor proxy que requiera autenticación. |
| /proxypassword:contraseña
o bien /pp:contraseña |
Especifica la contraseña que se utiliza para conectarse a un servidor proxy que requiera autenticación. |
| /proxyusername:nombre de usuario
o bien /pu:nombre de usuario |
Especifica el nombre de usuario que se utiliza para conectarse a un servidor proxy que requiera autenticación. |
| /server | Genera una clase abstracta para un servicio Web XML basada en contratos. El valor predeterminado es que se generen clases proxy cliente. |
| /u[sername]:nombre de usuario | Especifica el nombre de usuario que se utiliza para conectarse a un servidor que requiera autenticación. |
| /? | Muestra la sintaxis de comandos y opciones para la herramienta. |
Comentarios
Un archivo .wsdl es un documento XML escrito con una gramática denominada Lenguaje de descripción de servicios Web (WSDL). En este archivo se describe cómo se comporta un servicio Web XML y cómo se instruye a los clientes para que interactúen con el servicio.
Los documentos de descubrimiento de un servicio Web XML se pueden obtener utilizando la Herramienta Descubrimiento de servicios Web (Disco.exe). Los archivos que crea esta herramienta, .discomap, .disco, .wsdl y .xsd, se pueden utilizar como entrada para Wsdl.exe.
Cuando se utiliza Wsdl.exe para crear una clase de proxy, se crea un único archivo de código fuente en el lenguaje de programación especificado. Durante el proceso de generación del código fuente para la clase de proxy, la herramienta determina el tipo más adecuado para utilizarlo con los objetos especificados en la descripción de servicio. En algunos casos la herramienta utiliza un enfoque de denominador menos común para convertir los objetos a un tipo determinado. Como consecuencia, es posible que el tipo generado en la clase de proxy no sea el que desea o espera el programador. Por ejemplo, cuando Wsdl.exe encuentra un tipo ArrayList en una descripción de servicio, crea Object Array en la clase de proxy generada. Para garantizar que las conversiones de tipo de objeto sean correctas, abra el archivo que contiene la clase de proxy generada y cambie los tipos de objeto incorrectos al tipo de objeto esperado.
Ejemplos
El siguiente comando crea un archivo .wsdl para el servicio Web XML ubicado en la dirección URL especificada y una clase proxy cliente en lenguaje C# para el servicio Web XML.
wsdl http://hostServer/WebserviceRoot/WebServiceName.asmx?WSDL
El siguiente comando crea una clase proxy cliente en lenguaje C# para un servicio Web XML ubicado en la dirección URL especificada. La herramienta guarda la clase proxy cliente en el archivo myProxyClass.cs.
wsdl /out:myProxyClass.cs http://hostServer/WebserviceRoot/WebServiceName.asmx?WSDL
El siguiente comando crea una clase proxy cliente en lenguaje Visual Basic de Microsoft para un servicio Web XML ubicado en la dirección URL especificada. La herramienta guarda la clase proxy cliente en el archivo myProxyClass.vb.
wsdl /language:VB /out:myProxyClass.vb http://hostServer/WebserviceRoot/WebServiceName.asmx?WSDL
Vea también
Herramientas de .NET Framework | Herramienta Descubrimiento de servicios Web (Disco.exe) | Crear un proxy de servicio Web XML | Descripción de servicios Web XML | Información general acerca de servicios Web XML