Outil Soapsuds Tool (Soapsuds.exe)
L'outil Soapsuds Tool vous aide à compiler les applications clientes qui communiquent avec les services Web XML à l'aide d'une technique appelée Service d'accès distant. Soapsuds.exe exécute les fonctions suivantes :
Il crée des schémas XML qui décrivent les services exposés dans un assembly du Common Language Runtime.
Il crée des assemblys de runtime pour accéder aux services décrits par les schémas XML. Une définition de schéma peut représenter un fichier local ou être téléchargée dynamiquement à partir d'Internet.
soapsuds {-url:schemaUrl | -types:type1,assemblyname[,serviceEndpoint]
[;type2,assemblyname][...]] | -is:schemafile | -ia:assemblyfile} [options]
| Option | Description |
|---|---|
-domain: domain ou -d: domain |
Spécifie le nom de domaine à utiliser lors d'une connexion à un serveur qui requiert une authentification par nom de domaine. |
-generatecode ou -gc |
Génère du code. Cette option équivaut à utiliser -od:., où le point supplémentaire indique que le code doit être placé dans le répertoire actif. |
-httpproxyname: name ou -hpn: name |
Spécifie le nom du proxy HTTP à utiliser lors de la connexion à un serveur via un serveur proxy HTTP. |
-httpproxyport: number ou -hpp: number |
Spécifie le numéro de port du proxy HTTP à utiliser lors de la connexion à un serveur via un serveur proxy HTTP. |
-inputassemblyfile: assemblyfile ou -ia: assemblyfile |
Spécifie le fichier d'assembly d'entrée. L'outil importe tous les types à partir de l'assembly. Lorsque vous spécifiez un assembly d'entrée, n'incluez pas les extensions .exe ou .dll. |
-inputdirectory: directory ou -id: directory |
Spécifie l'emplacement du répertoire des fichiers de bibliothèque de liens dynamiques (DLL) d'entrée. |
-inputschemafile: schemafile ou -is: schemafile |
Spécifie le fichier de schéma XML d'entrée. |
-nowrappedproxy ou -nowp |
Ne crée pas de proxy encapsulé. Si vous ne spécifiez pas cette option, l'outil crée un proxy encapsulé. |
-outputassemblyfile: assemblyfile ou -oa: assemblyfile |
Enregistre le résultat dans le fichier d'assembly spécifié. Soapsuds.exe génère toujours du code source lorsqu'il génère un assembly. |
-outputdirectory: outputdirectory ou -od: outputdirectory |
Enregistre le résultat dans le répertoire de sortie spécifié. |
-outputschemafile: schemafile ou -os: schemafile |
Enregistre le résultat dans le fichier de schéma XML spécifié. |
-password: password ou -p: password |
Spécifie le mot de passe à utiliser lors d'une connexion à un serveur qui requiert une authentification. |
-proxynamespace: namespace ou -pn |
Spécifie l'espace de noms du code dans le proxy généré. Utilisez cette option pour les espaces de noms d'interopérabilité uniquement. |
-sdl |
Génère un schéma SDL (Service Description Language). Si vous ne spécifiez pas cette option, l'outil génère un schéma WSDL (Web Services Description Language). Pour plus d'informations sur SDL, consultez Description de service Web. |
-serviceendpoint: URL ou -se: URL |
Spécifie l'URL ou le chemin d'accès vers l'URL pour le point de terminaison du service, à placer dans le fichier WSDL. |
-strongnamefile: filename ou -sn: filename |
Signe l'assembly généré avec la paire de clés présente dans filename. Vous pouvez générer ce fichier à l'aide de l'Outil Strong Name Tool (Sn.exe). |
-types: type1,assemblyname[,serviceEndpoint] [;type2,assemblyname[,serviceEndpoint]] [...] |
Spécifie la liste des types d'entrée. |
-urltoschema:schemaURL ou -url:schemaURL |
Spécifie l'URL à partir de laquelle le schéma XML doit être récupéré. |
-username: username ou -u: username |
Spécifie le nom d'utilisateur à utiliser lors d'une connexion à un serveur qui requiert une authentification. |
-wrappedproxy ou -wp |
Crée un proxy encapsulé. Il s'agit de l'option par défaut. |
-wsdl |
Génère un schéma WSDL. Il s'agit de l'option par défaut. Pour plus d'informations, consultez Description de service Web. |
Notes
Suivez les étapes ci-dessous pour accéder à un service Web XML à partir de votre application cliente :
Téléchargez le schéma XML pour le service Web XML. L'option -urltoschema de l'outil vous permet de faire directement référence au schéma à partir de son URL. Un service Web XML génère ces fichiers de schéma automatiquement lors de la publication du service Web XML.
Convertissez le schéma XML en assembly de runtime à l'aide de Soapsuds.exe. Cet outil génère toujours du code source lorsqu'il génère un assembly.
Faites référence à cet assembly dans votre application cliente lorsque vous compilez l'application. Vous devez également installer le Service d'accès distant pour permettre à vos applications d'identifier les types de ces assemblys comme les proxies des services Web XML. Pour plus d'informations, consultez Vue d'ensemble de .NET Remoting.
Exemples
La commande suivante télécharge un schéma à partir d'une URL et l'enregistre dans un fichier XML.
soapsuds -url:https://localhost/Service/MyService.soap?wsdl
-os:MyService.xml
La commande suivante télécharge un schéma à partir d'une URL et génère du code.
soapsuds -url:https://localhost/Service/MyService.soap?wsdl -gc
La commande suivante télécharge un schéma à partir d'une URL, l'enregistre dans un fichier et génère du code.
soapsuds -url:https://localhost/Service/MyService.soap?wsdl
-os:StockQuote.xml -gc
La commande suivante télécharge un schéma à partir d'une URL, génère du code, le compile et génère un assembly.
soapsuds -url:https://localhost/Service/MyService.soap?wsdl
-oa:StockQuote.dll
La commande suivante convertit un type en schéma et l'enregistre dans un fichier.
soapsuds -types:MyClass.MyMethod,Service -os:StockQuote.xml
La commande suivante convertit un type en schéma et génère du code.
soapsuds -types:MyClass.MyMethod,Service -gc
La commande suivante convertit un type en schéma, l'enregistre dans un fichier et génère du code.
soapsuds -types:MyClass.MyMethod,Service -os:MyService.xml -gc
Voir aussi
Référence
Outils du .NET Framework
Outil Strong Name Tool (Sn.exe)
Outil Web Services Description Language Tool (Wsdl.exe)
Outil Web Services Discovery Tool (Disco.exe)
Invite de commandes du Kit de développement SDK
Concepts
Vue d'ensemble des services Web XML