Partager via


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.

xd176a6c.note(fr-fr,VS.100).gifRemarque :
À 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 :

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

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

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