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

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

Web 服务描述语言工具从 WSDL 协定文件、XSD 架构和 .discomap 发现文档为 XML Web services 和 XML Web services 客户端生成代码。

注意：
WSDL.exe 可能会生成其名称类似于“@string”的类。这些是使用“@”前缀的有效类型名称，旨在允许使用包含 C# 关键字的类型名称。

wsdl [options] {URL | path}

备注

参数	说明
URL	指向 WSDL 协定文件 (.wsdl)、XSD 架构文件 (.xsd) 或发现文档 (.disco) 的 URL。请注意，您不能将 URL 指定为 .discomap 发现文档。
Path	本地 WSDL 协定文件 (.wsdl)、XSD 架构文件 (.xsd) 或发现文档（.disco 或 .discomap）的路径。 注意： 在给定本地文件时，Wsdl.exe 不会检索网络上包含和导入的内容。若要使 Wsdl.exe 可以在处理本地文件的同时检索网络资源，请传递本地文件的 URL。例如，以下文件使用网络检索必需的资源： wsdl File:///E:/Customers/WSDLS/Accounts.wsdl /out:proxy.cs

.wsdl 文件是一个使用称作 Web 服务描述语言 (WSDL) 的 XML 语法编写的 XML 文档。此文件定义 XML Web services 的行为方式并指示客户端如何与该服务交互。

可以使用 Web 服务发现工具 (Disco.exe) 获得 XML Web services 的发现文档。由此工具生成的 .discomap、.disco、.wsdl 和 .xsd 文件可以用作 Wsdl.exe 的输入。

当您使用 Wsdl.exe 创建代理类时，将用指定的编程语言创建一个源文件。在为代理类生成源代码的过程中，该工具确定服务说明中指定的对象最适用的类型。在某些情况下，该工具使用最小公分母方法将这些对象强制转换为某个类型。因此，代理类中的生成类型可能不是开发人员想要或预期的类型。例如，当 Wsdl.exe 遇到服务说明中的 ArrayList 类型时，它会在生成的代理类中创建一个 Object 数组。若要确保对象类型强制转换正确，请打开包含生成的代理类的文件，然后将所有不正确的对象类型更改成所需的对象类型。

• / parameters 选项指定一个文件，该文件包含与大多数命令提示符选项相对应的元素。有些命令提示符选项只以 /parameters 文件格式提供。

/ parameters 选项接受的 XML 文件格式是外部 <wsdlParameters xmlns="https://microsoft.com/webReference/"> 元素内的一系列元素。如果指定了命令提示符值，并且使用了包含不同选项或值的 /parameters 文件，则使用在命令提示符处指定的值。<wsdlParameters xmlns="https://microsoft.com/webReference/"> 元素必须包含一个 <nologo> 元素、一个 <parsableerrors> 元素和一个 <sharetypes> 元素。

多个选项作为 <webReferenceOptions> 元素（必须包含一个 <verbose> 元素）的子元素传递。<webReferenceOptions> 的其他子元素为：

• <style>. 包含“client”、“server”或“serverInterface”。

• <schemaImporterExtension>. 包含任意数量的 <type> 元素。

• <codeGenerationOptions>. 可接受下列字符串的集合（由空格分隔）。

• “properties”

• “newAsync”

• “oldAsync”

• “order”

• “enableDataBinding”

请参见下面的“示例”部分，以获取 /parameters 选项的一些演示。

示例

下面的命令用 C# 语言创建 XML Web services 的客户端代理类。

wsdl http://hostServer/WebserviceRoot/WebServiceName.asmx?WSDL

下面的命令用 C# 语言为位于指定 URL 处的 XML Web services 创建客户端代理类。该工具将客户端代理类保存在 myProxyClass.cs 文件中。

wsdl /out:myProxyClass.cs http://hostServer/WebserviceRoot/WebServiceName.asmx?WSDL

下面的命令用 Microsoft Visual Basic 语言为位于指定 URL 处的 XML Web services 创建客户端代理类。该工具将客户端代理类保存在 myProxyClass.vb 文件中。

wsdl /language:VB /out:myProxyClass.vb http://hostServer/WebserviceRoot/WebServiceName.asmx?WSDL

下面的代码示例演示一个基本的 /parameters WSDL 文件，其中只编写了可在命令提示符处与 URL 参数结合使用的必需元素。

<wsdlParameters xmlns="https://microsoft.com/webReference/">
  <nologo>true</nologo>
  <parsableerrors>true</parsableerrors>
  <sharetypes>true</sharetypes>
</wsdlParameters>

WSDL 文档是通过 <documents> 元素添加到 /parameters WSDL 文件中的，如下面的代码示例所示。在 <documents> 元素中可以使用任意数目的 <document> 元素。

<wsdlParameters xmlns="https://microsoft.com/webReference/">
  <nologo>true</nologo>
  <parsableerrors>true</parsableerrors>
  <sharetypes>true</sharetypes>
  <documents>
    <document>https://www.contoso.com/service.asmx?WSDL</document>
  </documents>
</wsdlParameters>

下面的 /parameters WSDL 文件演示 <webReferenceOptions> 元素内的 <codeGenerationOptions> 和 <style> 元素的用法。在本示例中，文件在代理代码中启用了新的数据绑定样式，并指定了一个架构导入程序扩展。在此扩展中，输出不显示详细信息，客户端代理由 Wsdl.exe 创建。

<wsdlParameters xmlns="https://microsoft.com/webReference/">
  <nologo>true</nologo>
  <parsableerrors>true</parsableerrors>
  <sharetypes>true</sharetypes>
  <documents>
    <document>https://www.contoso.com/service.asmx?WSDL</document>
  </documents>
  <webReferenceOptions>
    <verbose>false</verbose>
    <codeGenerationOptions>properties newAsync enableDataBinding</codeGenerationOptions>
    <schemaImporterExtension>
      <type>MyNamespace.MyCustomImporterExtension,ExtensionLibrary</type>
    </schemaImporterExtensions>
    <style>client</style>
  </webReferenceOptions>
</wsdlParameters>

另请参见

参考

Web 服务发现工具 (Disco.exe)

概念

创建 XML Web services 代理
XML Web services 说明
XML Web services 概述

其他资源

.NET Framework Tools
SDK Command Prompt