SoapSuds-Tool (Soapsuds.exe)

  • Artikel

Dieses Thema bezieht sich auf eine veraltete Technologie. XML-Webdienste und XML-Webdienstclients sollten nun mithilfe der folgenden Technologie erstellt werden: Windows Communication Foundation.

Das Soapsuds-Tool dient zum Kompilieren von Clientanwendungen, die mit XML-Webdiensten über das so genannte Remoting kommunizieren. Soapsuds.exe führt folgende Funktionen aus:

  • Erstellen von XML-Schemas, die Dienste in einer Common Language Runtime-Assembly beschreiben.

  • Erstellen von Laufzeitassemblys für den Zugriff auf Dienste, die durch XML-Schemas beschrieben sind. Eine Schemadefinition kann eine lokale Datei sein oder dynamisch aus dem Internet heruntergeladen werden.

xd176a6c.note(de-de,VS.100).gifHinweis:
Ab .NET Framework, Version 3.5 ist dieses Tool veraltet. Legen Sie stattdessen einen Verweis auf die DLL des Remoteobjekts im Clientprojekt fest. Dadurch wird dem Compiler ermöglicht, die Metadaten zu extrahieren. 

soapsuds {-url:schemaUrl | -types:type1,assemblyname[,serviceEndpoint]
[;type2,assemblyname][...]] | -is:schemafile | -ia:assemblyfile} [options]

Optionen

Option Beschreibung

-domain:domain

oder

-d:domain

Gibt den Domänennamen für die Verbindung mit einem Server an, der für die Authentifizierung einen Domänennamen benötigt.

-generatecode

oder

-gc

Generiert Code. Diese Option entspricht -od:., wobei der zusätzliche Punkt angibt, dass der Code im aktuellen Verzeichnis abgelegt werden soll.

-httpproxyname:name

oder

-hpn:name

Gibt den HTTP-Proxynamen für die Verbindung über einen HTTP-Proxyserver an.

-httpproxyport:number

oder

-hpp:number

Gibt die HTTP-Proxyanschlussnummer für die Verbindung über einen HTTP-Proxyserver an.

-inputassemblyfile:assemblyfile

oder

-ia:assemblyfile

Gibt die Eingabeassemblydatei an. Das Tool importiert alle Typen aus der Assembly. Geben Sie eine Eingabeassembly ohne die Erweiterung .exe oder .dll an.

-inputdirectory:directory

oder

-id:directory

Gibt den Pfad des Verzeichnisses der Dynamic Link Library (DLL)-Eingabedateien an.

-inputschemafile:schemafile

oder

-is:schemafile

Gibt die XML-Eingabeschemadatei an.

-nowrappedproxy

oder

-nowp

Es wird kein Wrapper-Proxy erstellt. Wenn Sie diese Option nicht angeben, wird standardmäßig ein Wrapper-Proxy erstellt.

-outputassemblyfile:assemblyfile

oder

-oa:assemblyfile

Speichert die Ausgabe in der angegebenen Assemblydatei. Durch Soapsuds.exe wird beim Erstellen einer Assembly immer Quellcode generiert.

-outputdirectory:outputdirectory

oder

-od:outputdirectory

Speichert die Ausgabe im angegebenen Ausgabeverzeichnis.

-outputschemafile:schemafile

oder

-os:schemafile

Speichert die Ausgabe in der angegebenen XML-Schemadatei.

-password:password

oder

-p:password

Gibt das Kennwort für die Verbindung mit einem Server an, für den Authentifizierung erforderlich ist.

-proxynamespace:namespace

oder

-pn:namespace

Gibt den Namespace für den Code im generierten Proxy an. Verwenden Sie diese Option nur für Interoperabilitätsnamespaces.

-sdl

Erstellt ein SDL (Service Description Language)-Schema. Wenn Sie diese Option nicht angeben, erstellt das Tool standardmäßig ein WSDL (Web Services Description Language)-Schema. Weitere Informationen zu SDL erhalten Sie unter Webdienstbeschreibung.

-serviceendpoint:URL

oder

-se:URL

Gibt die URL oder den Pfad zur URL an, wo der Endpunkt für den Dienst in der WSDL-Datei gesetzt werden soll.

-strongnamefile:filename

oder

-sn:filename

Signiert die Assembly beim Generieren mit dem in filename angegebenen Schlüsselpaar. Sie können diese Datei mit dem Strong Name-Tool (Sn.exe) generieren.

-types: type1,assemblyname[,serviceEndpoint] [;type2,assemblyname[,serviceEndpoint]] [...]

Gibt die Eingabetypliste an.

-urltoschema:schemaURL

oder

-url:schemaURL

Gibt die URL an, von der das XML-Schema abgerufen wird.

-username:username

oder

-u:username

Gibt den Benutzernamen für die Verbindung mit einem Server an, für den Authentifizierung erforderlich ist.

-wrappedproxy

oder

-wp

Erstellt einen Wrapper-Proxy. Dies ist die Standardeinstellung.

-wsdl

Generiert ein WSDL-Schema. Dies ist die Standardeinstellung. Weitere Informationen finden Sie unter  XML-Webdienstbeschreibung

Hinweise

Führen Sie folgende Schritte aus, um von der Clientanwendung aus auf einen XML-Webdienst zuzugreifen:

  1. Laden Sie das XML-Schema für den XML-Webdienst herunter. (Mit der -urltoschema-Option des Tools können Sie direkt über die URL darauf verweisen.) Ein XML-Webdienst generiert diese Schemadateien automatisch, wenn er veröffentlicht wird.

  2. Konvertieren Sie das XML-Schema mit Soapsuds.exe in eine Laufzeitassembly. Das Tool generiert beim Erstellen einer Assembly immer Quellcode.

  3. Verweisen Sie in der Clientanwendung auf diese Assembly, wenn Sie die Anwendung kompilieren. Sie müssen außerdem Remoting einrichten, sodass die Anwendung die Typen in diesen Assemblys als Proxys für XML-Webdienste erkennt. Weitere Informationen finden Sie unter  Übersicht über .NET Remoting

Beispiele

Durch folgenden Befehl wird ein Schema von einer URL heruntergeladen und in einer XML-Datei gespeichert.

soapsuds -url:https://localhost/Service/MyService.soap?wsdl 
-os:MyService.xml

Durch folgenden Befehl wird ein Schema von einer URL heruntergeladen und Code generiert.

soapsuds -url:https://localhost/Service/MyService.soap?wsdl -gc

Durch folgenden Befehl wird ein Schema von einer URL heruntergeladen und in einer Datei gespeichert sowie Code generiert.

soapsuds -url:https://localhost/Service/MyService.soap?wsdl 
-os:StockQuote.xml -gc

Durch folgenden Befehl wird ein Schema von einer URL heruntergeladen, Code generiert, kompiliert und eine Assembly generiert.

soapsuds -url:https://localhost/Service/MyService.soap?wsdl 
-oa:StockQuote.dll

Durch folgenden Befehl wird ein Typ in ein Schema konvertiert und in einer Datei gespeichert.

soapsuds -types:MyClass.MyMethod,Service -os:StockQuote.xml

Durch folgenden Befehl wird ein Typ in ein Schema konvertiert und Code generiert.

soapsuds -types:MyClass.MyMethod,Service -gc

Durch folgenden Befehl wird ein Typ in ein Schema konvertiert und in einer Datei gespeichert sowie Code generiert.

soapsuds -types:MyClass.MyMethod,Service -os:MyService.xml -gc

Siehe auch

Verweis

Web Services Description Language-Tool (Wsdl.exe)
Web Services Discovery-Tool (Disco.exe)

Konzepte

Übersicht über XML-Webdienste

Weitere Ressourcen

.NET Framework Tools
.NET Remoting Overview
Strong Name Tool (Sn.exe)
SDK Command Prompt