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}

Comentarios

Argumento	Descripción
Direcció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).
Ruta de acceso	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). Nota: Wsdl.exe no recupera inclusiones e importaciones de la red cuando se proporciona un archivo local. Para permitir que Wsdl.exe recupere recursos de red al procesar un archivo local, pase una dirección URL al archivo local. Por ejemplo, el archivo siguiente usa la red para recuperar los recursos necesarios: wsdl File:///E:/Customers/WSDLS/Accounts.wsdl /out:proxy.cs

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 usar 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 usa 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.

• La opción /parameters especifica un archivo que contiene elementos que se corresponden con la mayoría de las opciones de símbolo del sistema. Algunas opciones del símbolo del sistema sólo están disponibles en los formatos de archivo /parameters.

El formato del archivo XML aceptado por la opción /parameters está formado por una serie de elementos incluidos dentro de un elemento <wsdlParameters xmlns="https://microsoft.com/webReference/"> exterior. Si se especifican valores del símbolo del sistema y se usa un archivo /parameters que contiene distintas opciones o valores, se utilizan los valores especificados en el símbolo del sistema. El elemento <wsdlParameters xmlns="https://microsoft.com/webReference/"> debe incluir un elemento <nologo>, un elemento <parsableerrors> y un elemento <sharetypes>.

Se pasan varias opciones como elementos secundarios del elemento <webReferenceOptions>, que debe incluir un elemento <verbose>. Otros elementos secundarios de <webReferenceOptions> son los siguientes:

• <style>. Contiene un valor "client", "server" o "serverInterface".

• <schemaImporterExtension>. Contiene cualquier número de elementos <type>.

• <codeGenerationOptions>. Puede obtener un conjunto delimitado por espacios de las siguientes cadenas.

• "properties"

• "newAsync"

• "oldAsync"

• "order"

• "enableDataBinding"

Consulte la siguiente sección Ejemplos para obtener algunas demostraciones de la opción /parameters.

Ejemplos

El siguiente comando crea una clase de proxy de cliente en lenguaje C# para el servicio web XML.

wsdl http://hostServer/WebserviceRoot/WebServiceName.asmx?WSDL

El siguiente comando crea una clase de proxy cliente en lenguaje C# para un servicio web XML ubicado en la dirección URL especificada. La herramienta guarda la clase de proxy cliente en el archivo myProxyClass.cs.

wsdl /out:myProxyClass.cs http://hostServer/WebserviceRoot/WebServiceName.asmx?WSDL

El siguiente comando crea una clase de 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 de proxy cliente en el archivo myProxyClass.vb.

wsdl /language:VB /out:myProxyClass.vb http://hostServer/WebserviceRoot/WebServiceName.asmx?WSDL

En el siguiente código de ejemplo se muestra un archivo WSDL /parameters básico, que sólo tiene escritos los elementos requeridos que se pueden usar en combinación con un argumento URL en el símbolo del sistema.

<wsdlParameters xmlns="https://microsoft.com/webReference/">
  <nologo>true</nologo>
  <parsableerrors>true</parsableerrors>
  <sharetypes>true</sharetypes>
</wsdlParameters>

Los documentos WSDL se agregan al archivo WSDL /parameters mediante el elemento <documents>, como se muestra en el siguiente ejemplo de código. Se puede usar cualquier número de elementos <document> dentro del elemento <documents>.

<wsdlParameters xmlns="https://microsoft.com/webReference/">
  <nologo>true</nologo>
  <parsableerrors>true</parsableerrors>
  <sharetypes>true</sharetypes>
  <documents>
    <document>https://www.contoso.com/service.asmx?WSDL</document>
  </documents>
</wsdlParameters>

En el siguiente archivo WSDL /parameters se muestra el uso de los elementos <codeGenerationOptions> y <style> dentro del elemento <webReferenceOptions>. En este caso, el archivo permite el nuevo estilo de enlace de datos en el código proxy, y especifica una extensión de importador de esquemas, que los resultados no deben ser detallados y que Wsdl.exe debe crear un servidor proxy de cliente.

<wsdlParameters xmlns="https://microsoft.com/webReference/">
  <nologo>true</nologo>
  <parsableerrors>true</parsableerrors>
  <sharetypes>true</sharetypes>
  <documents>
    <document>https://www.contoso.com/service.asmx?WSDL</document>
  </documents>
  <webReferenceOptions>
    <verbose>false</verbose>
    <codeGenerationOptions>properties newAsync enableDataBinding</codeGenerationOptions>
    <schemaImporterExtension>
      <type>MyNamespace.MyCustomImporterExtension,ExtensionLibrary</type>
    </schemaImporterExtensions>
    <style>client</style>
  </webReferenceOptions>
</wsdlParameters>

Consulte también

Referencia

Herramienta Descubrimiento de servicios web (Disco.exe)

Conceptos

Crear un proxy de servicio web XML
Descripción del servicio web XML
Información general de servicios web XML

Otros recursos

.NET Framework Tools
SDK Command Prompt

Copyright © 2007 Microsoft Corporation. Reservados todos los derechos.