Herramienta SoapSuds (Soapsuds.exe)

Este tema es específico de una tecnología heredada. Ahora, los servicios Web XML y los clientes de servicios Web XML deben crearse con Windows Communication Foundation.

La herramienta Soapsuds ayuda a compilar aplicaciones cliente que se utilizan para comunicar con servicios Web XML mediante una técnica denominada comunicació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.

xd176a6c.note(es-es,VS.100).gifNota:
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]

Opciones

Opción Descripción

-dominio: dominio

o bien

- d: 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: 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: 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: archivodeensamblado

O bien

- ia: archivoensamblado

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: archivodeesquema

O bien

-is: archivodeesquema

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: archivodeensamblado

O bien

- oa: archivodeensamblado

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

- outputdirectory: directorioderesultados

O bien

-od: directorioderesultados

Guarda los resultados en el directorio de resultados especificado.

-outputschemafile: archivodeesquema

O bien

-os: archivodeesquema

Guarda los resultados en el archivo del esquema XML especificado.

-password: contraseña

O bien

-p: contraseña

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

-proxynamespace: espacio de nombres

o bien

-pn:espacio de nombres

Especifica el espacio de nombres del código en el proxy generado. Utilice esta opción solo 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: 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).

-types: tipo1,nombredeensamblado[,serviceEndpoint] [;ipo2,nombredeensamblado[,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.

-username: 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. Este es el valor predeterminado.

-wsdl

Genera un esquema WSDL. Este es el valor predeterminado. Para obtener más información, vea Descripción del servicio Web XML.

Notas

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 comunicació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 Información general de .NET Remoting.

Ejemplos

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

soapsuds -url:http://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:http://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:http://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:http://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 

Vea 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