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