Strumento Soapsuds (Soapsuds.exe)
Questo argomento è specifico di una tecnologia legacy. Servizi Web XML e client di servizi Web XML devono essere creati attualmente tramite Windows Communication Foundation.
Lo strumento Soapsuds consente di compilare applicazioni client che comunicano con servizi Web XML tramite le funzionalità remote. Soapsuds.exe svolge le seguenti funzioni:
Creazione di schemi XML che descrivono i servizi esposti in un assembly di Common Language Runtime.
Creazione di assembly per il runtime che consentano di accedere ai servizi descritti dagli schemi XML. Una definizione di schema può risiedere in un file locale o può essere scaricata da Internet in modo dinamico.
.gif "xd176a6c.note(it-it,VS.100).gif") Nota: |
|---|
| Poiché inizia con .NET Framework versione 3.5, questo strumento è obsoleto. Impostare un riferimento a DLL dell'oggetto remoto nel progetto client. Così facendo, il compilatore può estrarre i metadati. |
soapsuds {-url:schemaUrl | -types:type1,assemblyname[,serviceEndpoint]
[;type2,assemblyname][...]] | -is:schemafile | -ia:assemblyfile} [options]
Opzioni
| Opzione | Descrizione |
|---|---|
-domain:dominio oppure -d:dominio |
Consente di specificare il nome di dominio da utilizzare per la connessione a un server che richiede un nome di dominio per l'autenticazione. |
-generatecode o -gc |
Consente di generare codice. Questa opzione è equivalente all'utilizzo di -od:., in cui il punto indica che il codice deve essere posizionato nella directory corrente. |
-httpproxyname:nome o -hpn:nome |
Consente di specificare il nome del proxy HTTP da utilizzare per la connessione a un server tramite un server proxy HTTP. |
-httpproxyport:numero o -hpp:numero |
Consente di specificare il numero di porta del proxy HTTP da utilizzare per la connessione a un server tramite un server proxy HTTP. |
-inputassemblyfile:fileassembly o -ia:fileassembly |
Consente di specificare il file di assembly di input. Lo strumento importa tutti i tipi dell'assembly. Quando si specifica un assembly di input, non includere l'estensione exe o dll. |
-inputdirectory:directory o -id:directory |
Consente di specificare il percorso della directory dei file DLL (Dynamic Link Library) di input. |
-inputschemafile:fileschema o -is:fileschema |
Consente di specificare il file degli schemi XML di input. |
-nowrappedproxy o -nowp |
Consente di non creare un proxy con wrapper. Se non si specifica questa opzione, lo strumento crea, per impostazione predefinita, un proxy con wrapper. |
-outputassemblyfile:fileassembly o -oa:fileassembly |
Consente di salvare l'output nel file di assembly specificato. Soapsuds.exe genera sempre codice sorgente quando genera un assembly. |
-outputdirectory:directoryoutput o -od: directoryoutput |
Consente di salvare l'output nella directory di output specificata. |
-outputschemafile:fileschema o -os:fileschema |
Consente di salvare l'output nel file degli schemi XML specificato. |
-password:password o -p:password |
Consente di specificare la password da utilizzare per la connessione a un server che richiede l'autenticazione. |
-proxynamespace:spazionomi oppure -pn:spazionomi |
Consente di specificare lo spazio dei nomi per il codice nel proxy generato. Utilizzare questa opzione solo per gli spazi dei nomi di interoperabilità. |
-sdl |
Consente di generare lo schema del linguaggio di descrizione dei servizi (SDL, Service Description Language). Se non si specifica questa opzione, lo strumento crea, per impostazione predefinita, lo schema del linguaggio di descrizione dei servizi Web (WSDL, Web Services Description Language). Per ulteriori informazioni su SDL, vedere Descrizione dei servizi Web. |
-serviceendpoint:URL o -se:URL |
Consente di specificare l'URL o il percorso dell'URL per l'endpoint del servizio da inserire nel file WSDL. |
-strongnamefile:nomefile o -sn:nomefile |
Consente di firmare l'assembly che viene generato con la coppia di chiavi presente in filename. È possibile generare questo file utilizzando lo strumento Nome sicuro (Sn.exe). |
-types: tipo1,nomeassembly[,Endpointservizio] [;tipo2,nomeassembly[,Endpointservizio]] [...] |
Consente di specificare l'elenco dei tipi di input. |
-urltoschema:URLschema o -url:URLschema |
Consente di specificare l'URL dal quale recuperare lo schema XML. |
-username:nomeutente o -u:nomeutente |
Consente di specificare il nome utente da utilizzare per la connessione a un server che richiede l'autenticazione. |
-wrappedproxy o -wp |
Consente di creare un proxy con wrapper. Questa è l'impostazione predefinita. |
-wsdl |
Consente di generare uno schema WSDL. Questa è l'impostazione predefinita. Per ulteriori informazioni, vedere Descrizione del servizio Web. |
Osservazioni
Per accedere a un servizio Web XML dall'applicazione client, attenersi alla procedura riportata di seguito:
Scaricare lo schema XML per il servizio Web XML. L'opzione -urltoschema dello strumento consente di fare riferimento direttamente a questo schema in base al relativo URL. Un servizio Web XML genera i file di schema automaticamente quando pubblica il servizio Web XML.
Convertire lo schema XML in un assembly runtime utilizzando Soapsuds.exe. Questo strumento genera sempre codice sorgente quando genera un assembly.
Quando si compila l'applicazione client, includere nell'applicazione un riferimento a questo assembly. È necessario anche impostare le funzionalità remote in modo che l'applicazione riconosca i tipi presenti in questi assembly come proxy dei servizi Web XML. Per ulteriori informazioni, vedere Cenni preliminari su .NET Remoting.
Esempi
Il comando riportato di seguito consente di effettuare il download di uno schema da un URL e salvarlo in un file XML.
soapsuds -url:https://localhost/Service/MyService.soap?wsdl
-os:MyService.xml
Il comando riportato di seguito consente di effettuare il download di uno schema da un URL e generare codice.
soapsuds -url:https://localhost/Service/MyService.soap?wsdl -gc
Il comando riportato di seguito consente di effettuare il download di uno schema da un URL, salvarlo in un file e generare codice.
soapsuds -url:https://localhost/Service/MyService.soap?wsdl
-os:StockQuote.xml -gc
Il comando riportato di seguito consente di effettuare il download di uno schema da un URL, generare codice, compilare e generare un assembly.
soapsuds -url:https://localhost/Service/MyService.soap?wsdl
-oa:StockQuote.dll
Il comando riportato di seguito consente di convertire un tipo in uno schema e salvarlo in un file.
soapsuds -types:MyClass.MyMethod,Service -os:StockQuote.xml
Il comando riportato di seguito consente di convertire un tipo in uno schema e generare codice.
soapsuds -types:MyClass.MyMethod,Service -gc
Il comando riportato di seguito consente di convertire un tipo in uno schema, salvarlo in un file e generare codice.
soapsuds -types:MyClass.MyMethod,Service -os:MyService.xml -gc
Vedere anche
Riferimento
Strumento del linguaggio di descrizione dei servizi Web (Wsdl.exe)
Strumento di individuazione servizi Web (Disco.exe)
Concetti
Panoramica dei servizi Web XML
Altre risorse
.NET Framework Tools
.NET Remoting Overview
Strong Name Tool (Sn.exe)
SDK Command Prompt