Herramienta Soapsuds (Soapsuds.exe)
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 preparados para tener acceso en tiempo de ejecución a los servicios descritos en los esquemas XML. Una definición de esquema puede ser un archivo local o se puede descargar dinámicamente de Internet.
soapsuds {-url:schemaUrl | -types:type1,assemblyname[,serviceEndpoint]
[;type2,assemblyname][...]] | -is:schemafile | -ia:assemblyfile} [options]
| Opción | Descripción |
|---|---|
| -domain: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 punto 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 utilizado 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 utilizado para conectarse a un servidor mediante un servidor proxy HTTP. |
| -inputassemblyfile:archivo de ensamblado
o bien -ia:archivo de ensamblado |
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:archivo de esquema
o bien -is:archivo de esquema |
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:archivo de ensamblado
o bien -oa:archivo de ensamblado |
Guarda los resultados en el archivo del ensamblado especificado. Soapsuds.exe genera siempre código fuente al crear un ensamblado. |
| -outputdirectory:directorio de resultados
o bien -od:directorio de resultados |
Guarda los resultados en el directorio de resultados especificado. |
| -outputschemafile:archivo de esquema
o bien -os:archivo de esquema |
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 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:URL
o bien -se: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: type1,nombre de ensamblado[,serviceEndpoint] [;type2,nombre de ensamblado[,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. Éste es el valor predeterminado. |
| -wsdl | Genera un esquema WSDL. Éste es el valor predeterminado. Para obtener más información, vea el tema Descripción de servicios Web. |
Comentarios
Para tener acceso a un servicio Web XML desde la aplicación cliente, es preciso seguir estos pasos:
- 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.
- Convertir el esquema XML en un ensamblado de motor de tiempo de ejecución utilizando Soapsuds.exe. Esta herramienta siempre genera código fuente cuando crea un ensamblado.
- 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 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: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
Vea también
Herramientas de .NET Framework | Información general de .NET Remoting | Herramienta Nombre seguro (Sn.exe) | Información general sobre servicios Web | Herramienta Lenguaje de descripción de servicios Web (Wsdl.exe) | Herramienta Descubrimiento de servicios Web (Disco.exe)