Soapsuds 工具 (Soapsuds.exe)
Soapsuds 工具帮助您编译使用称为远程的技术与 XML Web services 进行通信的客户端应用程序。Soapsuds.exe 执行以下功能：
它创建 XML 架构，用于描述在公共语言运行库程序集中公开的服务。
它创建运行库程序集，以访问由 XML 架构描述的服务。架构定义既可以是本地文件，也可以从 Internet 上动态下载。
soapsuds {-url:schemaUrl | -types:type1,assemblyname[,serviceEndpoint]
[;type2,assemblyname][...]] | -is:schemafile | -ia:assemblyfile} [options]
| 选项 | 说明 |
|---|---|
-domain: domain 或 -d: domain |
指定当连接到要求域名称以进行身份验证的服务器时要使用的域名称。 |
-generatecode 或 -gc |
生成代码。此选项相当于使用 -od:.，od:. 末尾附加的句点表明该代码应放置在当前目录中。 |
-httpproxyname: name 或 -hpn: name |
指定当通过 HTTP 代理服务器连接到一个服务器时要使用的 HTTP 代理名称。 |
-httpproxyport: number 或 -hpp: number |
指定当通过 HTTP 代理服务器连接到一个服务器时要使用的 HTTP 代理端口号。 |
-inputassemblyfile: assemblyfile 或 -ia: assemblyfile |
指定输入程序集文件。该工具导入程序集中的所有类型。当您指定输入程序集时，不要包括 .exe 或 .dll 扩展名。 |
-inputdirectory: directory 或 -id: directory |
指定输入动态链接库 (DLL) 文件的目录位置。 |
-inputschemafile: schemafile 或 -is: schemafile |
指定输入 XML 架构文件。 |
-nowrappedproxy 或 -nowp |
不创建绕线代理。如果您没有指定此选项，则该工具将默认为创建绕线代理。 |
-outputassemblyfile: assemblyfile 或 -oa: assemblyfile |
将输出保存到指定的程序集文件。Soapsuds.exe 在生成程序集时始终生成源代码。 |
-outputdirectory: outputdirectory 或 -od: outputdirectory |
将输出保存到指定的输出目录。 |
-outputschemafile: schemafile 或 -os: schemafile |
将输出保存到指定的 XML 架构文件。 |
-password: password 或 -p: password |
指定连接到要求身份验证的服务器时要使用的密码。 |
-proxynamespace: namespace 或 -pn |
指定生成的代理中代码的命名空间。只应将此选项用于 Interop 命名空间。 |
-sdl |
生成服务描述语言 (SDL) 架构。如果不指定此选项，则此工具将生成 Web 服务描述语言 (WSDL) 架构。有关 SDL 的更多信息，请参见 Web 服务说明。 |
-serviceendpoint: URL 或 -se: URL |
指定放置在 WSDL 文件中的服务端点的 URL 或到该端点的 URL 的路径。 |
-strongnamefile: filename 或 -sn: filename |
用 filename 中的键对来签发所生成的程序集。可以使用强名称工具 (Sn.exe) 来生成此文件。 |
-types: type1,assemblyname[,serviceEndpoint] [;type2,assemblyname[,serviceEndpoint]] [...] |
指定输入类型列表。 |
-urltoschema:schemaURL 或 -url:schemaURL |
指定从其中检索 XML 架构的 URL。 |
-username: username 或 -u: username |
指定连接到要求身份验证的服务器时要使用的用户名。 |
-wrappedproxy 或 -wp |
创建绕线代理。这是默认设置。 |
-wsdl |
生成 WSDL 架构。这是默认设置。有关更多信息，请参见 Web 服务说明。 |
备注
遵循以下步骤来从客户端应用程序访问 XML Web services：
下载 XML Web services 的 XML 架构。（此工具的 -urltoschema 选项使您可以直接按其 URL 来引用它。）在发布 XML Web services 时，XML Web services 将自动生成这些架构文件。
使用 Soapsuds.exe 将 XML 架构自动转换为运行库程序集。该工具在生成程序集时始终会生成源代码。
当编译客户端应用程序时，在该应用程序中引用此程序集。您还必须设置远程处理，以便应用程序将这些程序集中的类型识别为 XML Web services 的代理。有关更多信息，请参见 .NET 远程处理概述。
示例
以下命令从 URL 下载一个架构并将该架构保存到 XML 文件中。
soapsuds -url:https://localhost/Service/MyService.soap?wsdl
-os:MyService.xml
以下命令从 URL 下载一个架构并生成代码。
soapsuds -url:https://localhost/Service/MyService.soap?wsdl -gc
以下命令从 URL 下载一个架构，将该架构保存到文件中，并生成代码。
soapsuds -url:https://localhost/Service/MyService.soap?wsdl
-os:StockQuote.xml -gc
以下命令从 URL 下载一个架构，生成代码，然后编译并生成一个程序集。
soapsuds -url:https://localhost/Service/MyService.soap?wsdl
-oa:StockQuote.dll
以下命令将一个类型转换为一个架构，并将该架构保存到文件中。
soapsuds -types:MyClass.MyMethod,Service -os:StockQuote.xml
以下命令将一个类型转换为一个架构并生成代码。
soapsuds -types:MyClass.MyMethod,Service -gc
以下命令将一个类型转换为一个架构，将该架构保存到文件中，并生成代码。
soapsuds -types:MyClass.MyMethod,Service -os:MyService.xml -gc
请参见
参考
.NET Framework 工具
强名称工具 (Sn.exe)
Web 服务描述语言工具 (Wsdl.exe)
Web 服务发现工具 (Disco.exe)
SDK 命令提示