如何:浏览 Web 服务内容

更新:2007 年 11 月

.asmx 文件表示用托管代码创建的 Web 服务的可寻址入口点。通过 HTTP 访问该文件的方式确定接收到响应的类型。

服务帮助页

当在 Web 浏览器中调用而不提供可以识别的查询字符串时,.asmx 文件返回自动生成的该 Web 服务的服务帮助页。这与在 .asmx 文件上执行 HTTP GET 是等效的。

此服务方法帮助页提供一个由 Web 服务提供的、可以通过编程方式访问的方法列表。该页包含每个方法的链接,这些链接将带您访问有关该方法的其他信息。此外,该页还包含指向 Web 服务说明文档的链接。

访问服务帮助页

  • 在浏览器的“地址”字段中,使用以下格式键入 Web 服务的基 URL:

    https://servername/projectname/webservicename.asmx
    

    参数

    servername

    Web 服务驻留在其上的服务器。

    projectname

    Web 服务的项目名称和访问 Web 服务的 .asmx 文件所需的任何其他目录信息。

    webservicename.asmx

    Web 服务的 .asmx 文件的名称。

    例如,若要访问名为 Service1.asmx 的 Web 服务(该服务是本地计算机上名为 WebService1 的项目的一部分),需要输入以下内容:

    https://localhost/WebService1/Service1.asmx
    

服务方法帮助页提供了与特定的 Web 服务方法相关的其他信息。

该页提供使用 HTTP-POST 协议调用该方法的能力。但是,Web 服务方法必须支持 HTTP-POST 协议才能启用此功能。

在该页的底部,服务方法帮助页提供该 Web 服务方法所支持协议的示例请求和响应消息。

服务说明

服务帮助页还提供了指向 Web 服务的服务说明的链接,服务说明是对 Web 服务功能的正式定义。服务说明是一个使用 Web 服务说明语言 (WSDL) 语法的文档。服务说明定义了在与 Web 服务交换消息时,客户端必须遵守的消息格式的协定。有关更多信息,请参见 XML Web services 说明

访问服务说明

  • 在浏览器的“地址”字段中,使用以下格式键入该 Web 服务的基 URL 并提供 WSDL 查询字符串:

    https://servername/projectname/webservicename.asmx?WSDL
    

    参数

    servername

    Web 服务驻留在其上的服务器。

    projectname

    Web 服务的项目名称和访问 Web 服务的 .asmx 文件所需的任何其他目录信息。

    webservicename.asmx

    Web 服务的 .asmx 文件的名称。

    例如,若要访问名为 Service1.asmx 的 Web 服务(该服务是本地计算机上名为 WebService1 的项目的一部分)的服务说明,需要输入以下内容:

    https://localhost/WebService1/Service1.asmx?WSDL
    

从 Web 浏览器访问 Web 服务

您可以从 Web 浏览器访问支持 HTTP-GET 协议的 Web 服务。默认情况下,在 Visual Studio 中使用 ASP.NET Web 服务项目模板创建的 Web 服务支持 HTTP-GET、HTTP-POST 和 HTTP-SOAP。并不是所有协议都可以支持所有方法。通常,HTTP-GET 和 HTTP-POST 协议在可以支持的数据类型方面的限制比 HTTP-SOAP 要多。

从 Web 浏览器访问 Web 服务

  • 在浏览器的“地址”字段,使用以下格式键入该 Web 服务的基 URL(查询字符串中具有方法名称和参数):

    https://servername/projectname/webservicename.asmx/methodname?parametername0=value0&parametername1=value1&...&parameternamen=valuen
    

    参数

    servername

    Web 服务驻留在其上的服务器。

    projectname

    Web 服务的项目名称和访问 Web 服务的 .asmx 文件所需的任何其他目录信息。

    webservicename.asmx

    Web 服务的 .asmx 文件的名称。

    methodname

    该 Web 方法的区分大小写的名称。

    parametername

    Web 方法参数的名称。

    value

    每个 Web 方法参数的 URL 编码值。

    例如,若要访问名为 Service1.asmx 的 Web 服务(该服务带有名为 MyString 且设置为值“This is my test string”的参数,并且该服务是本地计算机上名为 WebService1 的项目的一部分)的 ReturnThisString 方法,需要输入以下内容:

    https://localhost/WebService1/Service1.asmx/ReturnThisString?MyString=This+is+my+test+string
    

请参见

概念

XML Web services 说明

其他资源

在托管代码中创建 Web 服务