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

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

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

版权所有 (C) 2007 Microsoft Corporation。保留所有权利。