Herramienta SoapSuds (Soapsuds.exe)

  • Artículo

La herramienta Soapsuds ayuda a compilar aplicaciones cliente que se utilizan para comunicar con servicios web XML mediante una técnica denominada interacción remota. Soapsuds.exe realiza las siguientes funciones:

  • Crea esquemas XML que describen los servicios expuestos en un ensamblado de Common Language Runtime.

  • Crea ensamblados en tiempo de ejecución preparados para tener acceso a los servicios descritos por los esquemas XML. Una definición de esquema puede ser un archivo local o se puede descargar dinámicamente de Internet.

Nota:

Comenzando con .NET Framework versión 3.5, esta herramienta está obsoleta. En su lugar, establezca una referencia a la DLL del objeto remoto en el proyecto de cliente. Haciendo esto, el compilador puede extraer los metadatos.

 
soapsuds {-url:schemaUrl | -types:type1,assemblyname[,serviceEndpoint]
[;type2,assemblyname][...]] | -is:schemafile | -ia:assemblyfile} [options]
Opción Descripción

-dominio:dominio

O bien

- d:el dominio

Especifica el nombre de dominio que se utiliza para conectarse a un servidor que requiera un nombre de dominio para autenticación.

-generatecode

O bien

- gc

Genera código. Esta opción equivale a utilizar -od:.; el periodo adicional indica que el código se debe colocar en el directorio actual.

- httpproxyname:el nombre

O bien

-hpn:nombre

Especifica el nombre del proxy HTTP que se utiliza para conectarse a un servidor mediante un servidor proxy HTTP.

- httpproxyport:el número

O bien

-hpp:número

Especifica el número de puerto del proxy HTTP que se utiliza para conectarse a un servidor mediante un servidor proxy HTTP.

- inputassemblyfile: assemblyfile

O bien

- ia:assemblyfile

Especifica el archivo del ensamblado de entrada. Esta herramienta importa todos los tipos desde el ensamblado. Cuando se especifica un ensamblado de entrada, no se incluye ni la extensión .exe ni la extensión .dll.

- inputdirectory:directorio

O bien

- id.:directorio

Especifica la ubicación del directorio de los archivos de la biblioteca de vínculos dinámicos (DLL) de entrada.

- inputschemafile:schemafile

O bien

- es:schemafile

Especifica el archivo del esquema XML de entrada.

-nowrappedproxy

O bien

-nowp

No crea un proxy ajustado. Si no se especifica esta opción, la herramienta crea un proxy ajustado de forma predeterminada.

- outputassemblyfile:assemblyfile

O bien

- oa:assemblyfile

Guarda los resultados en el archivo del ensamblado especificado. Soapsuds.exe genera siempre código fuente al crear un ensamblado.

- outputdirectory:outputdirectory

O bien

- od:outputdirectory

Guarda los resultados en el directorio de resultados especificado.

-outputschemafile:schemafile

O bien

-os:schemafile

Guarda los resultados en el archivo del esquema XML especificado.

-contraseña:contraseña

O bien

- p:contraseña

Especifica la contraseña que se utiliza para conectarse a un servidor que requiera autenticación.

-proxynamespace:espacio de nombres

O bien

- pn

Especifica el espacio de nombres del código en el proxy generado. Utilice esta opción sólo para los espacios de nombres interoperativos.

- sdl

Genera un esquema SDL (Lenguaje de descripción de servicios). Si no se especifica esta opción, la herramienta genera un esquema WSDL (Lenguaje de descripción de servicios web). Para obtener más información sobre SDL, vea el tema Descripción de servicios web.

- serviceendpoint:dirección URL

O bien

- se:dirección URL

Especifica la dirección URL o la ruta de acceso a la dirección URL para el extremo del servicio que se coloca en el archivo WSDL.

- strongnamefile:el nombre de archivo

O bien

-sn:nombre de archivo

Firma el ensamblado que se genera con el par de claves que encuentra en el nombre de archivo. Este archivo se puede generar utilizando la Herramienta Nombre seguro (Sn.exe).

-tipos: type1,assemblyname[,serviceEndpoint] [;type2,assemblyname[,serviceEndpoint]] [...]

Especifica la lista de tipos de entrada.

-urltoschema:URL de esquema

O bien

-url:URL de esquema          

Especifica la dirección URL de la que se recupera el esquema XML.

- nombre de usuario:nombre de usuario

O bien

- u:nombre de usuario

Especifica el nombre de usuario que se utiliza para conectarse a un servidor que requiera autenticación.

-wrappedproxy

O bien

- wp

Crea un proxy ajustado. Éste es el predeterminado.

- wsdl

Genera un esquema WSDL. Éste es el predeterminado. Para obtener más información, vea Descripción de servicios web.

'

Comentarios

Para tener acceso a un servicio web XML desde la aplicación cliente, es preciso seguir estos pasos:

  1. Descargar el esquema XML para el servicio web XML. (la opción -urltoschema de la herramienta permite hacer una referencia directamente al esquema XML mediante la dirección URL). Los servicios web XML generan automáticamente los archivos de esquemas cuando publican el servicio web XML.

  2. Convierta el esquema XML en un ensamblado en tiempo de ejecución utilizando Soapsuds.exe. La herramienta genera siempre código fuente al crear un ensamblado.

  3. Hacer referencia a este ensamblado en la aplicación cliente cuando se compila la aplicación. Además, se debe configurar la interacción remota para que la aplicación reconozca los tipos de estos ensamblados como servidores proxy para servicios web XML. Para obtener más información, vea la comunicación remota con .NET.

Ejemplos

El siguiente comando descarga un esquema desde una dirección URL y lo guarda en un archivo XML.

soapsuds -url:https://localhost/Service/MyService.soap?wsdl 
-os:MyService.xml

El siguiente comando descarga un esquema desde una dirección URL y genera código.

soapsuds -url:https://localhost/Service/MyService.soap?wsdl -gc

El siguiente comando descarga un esquema desde una dirección URL, lo guarda en un archivo y genera código.

soapsuds -url:https://localhost/Service/MyService.soap?wsdl 
-os:StockQuote.xml -gc

El siguiente comando descarga un esquema desde una dirección URL, genera código, lo compila y genera un ensamblado.

soapsuds -url:https://localhost/Service/MyService.soap?wsdl 
-oa:StockQuote.dll

El siguiente comando convierte un tipo en un esquema y lo guarda en un archivo.

soapsuds -types:MyClass.MyMethod,Service -os:StockQuote.xml

El siguiente comando convierte un tipo en un esquema y genera código.

soapsuds -types:MyClass.MyMethod,Service -gc

El siguiente comando convierte un tipo en un esquema, lo guarda en un archivo y genera código.

soapsuds -types:MyClass.MyMethod,Service -os:MyService.xml -gc

Consulte también

Referencia

Herramienta Lenguaje de descripción de servicios web (Wsdl.exe)
Herramienta Descubrimiento de servicios web (Disco.exe)

Conceptos

Información general de servicios web XML

Otros recursos

.NET Framework Tools
.NET Remoting Overview
Strong Name Tool (Sn.exe)
SDK Command Prompt

Copyright © 2007 Microsoft Corporation. Reservados todos los derechos.