SoapSuds-Tool (Soapsuds.exe)

Článek
12/17/2007

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.

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

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	Gibt den Namespace für den Code im generierten Proxy an. Verwenden Sie diese Option nur für Interop-Namespaces.
-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 den URL oder den Pfad zum 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 den URL an, von dem 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 Webdienstbeschreibung.

Hinweise

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

Downloaden Sie das XML-Schema für den XML-Webdienst. (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.
Konvertieren Sie das XML-Schema mit Soapsuds.exe in eine Laufzeitassembly. Das Tool generiert beim Erstellen einer Assembly immer Quellcode.
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 einem URL gedownloadet und in einer XML-Datei gespeichert.

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

Durch folgenden Befehl wird ein Schema von einem URL gedownloadet und Code generiert.

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

Durch folgenden Befehl wird ein Schema von einem URL gedownloadet 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 einem URL gedownloadet, 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

Footer image

Sdílet prostřednictvím

SoapSuds-Tool (Soapsuds.exe)

Hinweise

Beispiele

Siehe auch

Referenz

Konzepte

Weitere Ressourcen

Další materiály