Soapsuds 工具 (Soapsuds.exe)

本主题专门介绍一项旧有技术。现在应通过使用以下链接来创建 XML Web 服务和 XML Web 服务客户端： Windows Communication Foundation.

Soapsuds 工具帮助您编译使用称为远程处理的技术与 XML Web services 进行通信的客户端应用程序。Soapsuds.exe 执行下列功能：

• 它创建 XML 架构，用于描述在公共语言运行库程序集中公开的服务。

• 它创建运行库程序集，以访问由 XML 架构描述的服务。架构定义既可以是本地文件，也可以从 Internet 上动态下载。

注意：
从 .NET Framework 3.5 版 开始，此工具已过时。改为在客户端项目中设置对远程对象 DLL 的引用。这样，编译器便可提取元数据。

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

选项

选项	说明
-domain:域 或 -d:域	指定当连接到要求提供域名称以进行身份验证的服务器时要使用的域名称。
-generatecode 或 -gc	生成代码。此选项相当于使用 -od:.，其末尾附加的句点表明该代码应放置在当前目录中。
-httpproxyname:名称 或 -hpn:名称	指定当通过 HTTP 代理服务器连接到一个服务器时要使用的 HTTP 代理名称。
-httpproxyport:编号 或 -hpp:编号	指定当通过 HTTP 代理服务器连接到一个服务器时要使用的 HTTP 代理端口号。
-inputassemblyfile:程序集文件 或 -ia:程序集文件	指定输入程序集文件。该工具导入程序集中的所有类型。当您指定输入程序集时，不要包括 .exe 或 .dll 扩展名。
-inputdirectory:目录 或 -id:目录	指定输入动态链接库 (DLL) 文件的目录位置。
-inputschemafile:架构文件 或 -is:架构文件	指定输入 XML 架构文件。
-nowrappedproxy 或 -nowp	不创建预包装代理。如果您没有指定此选项，则该工具将默认为创建预包装代理。
-outputassemblyfile:程序集文件 或 -oa:程序集文件	将输出保存到指定的程序集文件。Soapsuds.exe 在生成程序集时始终生成源代码。
-outputdirectory:输出目录 或 -od:输出目录	将输出保存到指定的输出目录。
-outputschemafile:架构文件 或 -os:架构文件	将输出保存到指定的 XML 架构文件。
-password:密码 或 -p:密码	指定连接到要求身份验证的服务器时要使用的密码。
-proxynamespace:命名空间 或 -pn:命名空间	指定生成的代理中代码的命名空间。只应将此选项用于互操作命名空间。
-sdl	生成服务描述语言 (SDL) 架构。如果不指定此选项，则该工具将生成 Web 服务描述语言 (WSDL) 架构。有关 SDL 的更多信息，请参见 Web 服务说明。
-serviceendpoint:URL 或 -se:URL	指定放置在 WSDL 文件中的服务端点的 URL 或到该端点的 URL 的路径。
-strongnamefile:文件名 或 -sn:文件名	用 filename 中的键对来签发所生成的程序集。可以使用强名称工具 (Sn.exe) 来生成此文件。
-types: 类型 1,程序集名称[,服务终结点] [;类型 2,程序集名称[,服务终结点]] [...]	指定输入类型列表。
-urltoschema:架构 URL 或 -url:架构 URL	指定从其中检索 XML 架构的 URL。
-username:用户名 或 -u:用户名	指定连接到要求身份验证的服务器时要使用的用户名。
-wrappedproxy 或 -wp	创建预包装代理。这是默认选项。
-wsdl	生成 WSDL 架构。这是默认选项。有关更多信息，请参见 Web 服务说明。

备注

遵循以下步骤来从客户端应用程序访问 XML Web services：

1. 下载 XML Web services 的 XML 架构。（此工具的 -urltoschema 选项使您可以直接按其 URL 来引用它。）在发布 XML Web services 时，XML Web services 将自动生成这些架构文件。

2. 使用 Soapsuds.exe 将 XML 架构转换为运行时程序集。该工具在生成程序集时始终生成源代码。

3. 当编译客户端应用程序时，在该应用程序中引用此程序集。您还必须设置远程处理，以便应用程序将这些程序集中的类型识别为 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 

另请参见

参考

Web 服务描述语言工具 (Wsdl.exe)
Web 服务发现工具 (Disco.exe)

概念

XML Web services 概述

其他资源

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