Outil Soapsuds Tool (Soapsuds.exe)
Cette rubrique est spécifique à une technologie existante. Les services Web XML et les clients du service Web XML doivent à présent être créés à l'aide de Windows Communication Foundation.
L'outil Soapsuds vous aide à compiler les applications clientes qui communiquent avec les services Web XML à l'aide d'une technique appelée Service de communication à distance. 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.
.gif "xd176a6c.note(fr-fr,VS.100).gif") Remarque : |
|---|
| À commencer par le .NET Framework version 3.5, cet outil est obsolète. À la place, affectez à une référence la DLL de l'objet distant dans le projet client. Ainsi, le compilateur peut extraire les métadonnées. |
soapsuds {-url:schemaUrl | -types:type1,assemblyname[,serviceEndpoint]
[;type2,assemblyname][...]] | -is:schemafile | -ia:assemblyfile} [options]
Options
| Option | Description |
|---|---|
-domain:domaine ou -d:domaine |
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:nom ou -hpn:nom |
Spécifie le nom du proxy HTTP à utiliser lors de la connexion à un serveur via un serveur proxy HTTP. |
-httpproxyport:numéro ou -hpp:numéro |
Spécifie le numéro de port du proxy HTTP à utiliser lors de la connexion à un serveur via un serveur proxy HTTP. |
-inputassemblyfile:fichierassembly ou -ia:fichierassembly |
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:répertoire ou -id:répertoire |
Spécifie l'emplacement du répertoire des fichiers de bibliothèque de liens dynamiques (DLL) d'entrée. |
-inputschemafile:fichierschéma ou -is:fichierschéma |
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:fichierassembly ou -oa:fichierassembly |
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:répertoiresortie ou -od:répertoiresortie |
Enregistre le résultat dans le répertoire de sortie spécifié. |
-outputschemafile:fichierschéma ou -os:fichierschéma |
Enregistre le résultat dans le fichier de schéma XML spécifié. |
-password:motdepasse ou -p:motdepasse |
Spécifie le mot de passe à utiliser lors d'une connexion à un serveur qui requiert une authentification. |
-proxynamespace:espacedenoms ou -pn:espacedenoms |
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:nomfichier ou -sn:nomfichier |
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,nomassembly[,pointdeterminaisonService] [;type2,nomassembly[,pointdeterminaisonService]] [...] |
Spécifie la liste des types d'entrée. |
-urltoschema:URLschéma ou -url:URLschéma |
Spécifie l'URL à partir de laquelle le schéma XML doit être récupéré. |
-username:nomutilisateur ou -u:nomutilisateur |
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 la valeur par défaut. |
-wsdl |
Génère un schéma WSDL. Il s'agit de la valeur par défaut. Pour plus d'informations, consultez Description du 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 un assembly d'exécution à l'aide de Soapsuds.exe. L'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 de communication à distance pour permettre à vos applications d'identifier les types de ces assemblys comme les proxys 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
Outil Web Services Description Language Tool (Wsdl.exe)
Outil Web Services Discovery Tool (Disco.exe)
Concepts
Vue d'ensemble des services Web XML
Autres ressources
.NET Framework Tools
.NET Remoting Overview
Strong Name Tool (Sn.exe)
SDK Command Prompt