Compartir a través de

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.

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

-domain: domain

O bien

-d: domain

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

O bien

-hpn: name

Especifica el nombre del proxy HTTP utilizado para conectarse a un servidor mediante un servidor proxy HTTP.

-httpproxyport: number

O bien

-hpp: number

Especifica el número de puerto del proxy HTTP utilizado 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: directory

O bien

-id: directory

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

-inputschemafile: schemafile

O bien

-is: 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.

-password: password

O bien

-p: password

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

-proxynamespace: namespace

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

O bien

-sn: filename

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,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.

-username: username

O bien

-u: username

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 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. Convertir el esquema XML en un ensamblado de motor en tiempo de ejecución utilizando Soapsuds.exe. Esta herramienta siempre genera código fuente cuando crea 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 Información general sobre el entorno remoto de .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

Vea también

Referencia

Herramientas de .NET Framework
Herramienta de nombre seguro (Sn.exe)
Herramienta Lenguaje de descripción de servicios Web (Wsdl.exe)
Herramienta Descubrimiento de servicios Web (Disco.exe)
Símbolo del sistema de SDK

Conceptos

Información general acerca de servicios Web XML

Otros recursos

Información general de .NET Framework Remoting