Partager via

Outil Soapsuds Tool (Soapsuds.exe)

  • Article

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.

NoteRemarque :

À 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]
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 :

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

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

Footer image

Copyright ©2007 par Microsoft Corporation. Tous droits réservés.