<protocols> 的 <add> 元素

添加 ASP.NET Web 服务可用来接收从客户端发送来的请求数据和返回响应数据的指定协议。 协议可用来将请求数据与方法及其参数关联起来，以及将响应数据与方法及其返回值关联起来。

<configuration>

  <system.web>

    <webServices> 元素

      <protocols> 元素

        <protocols> 的 <add> 元素

<add name="protocol name"/>

属性和元素

以下几节描述了属性、子元素和父元素。

属性

属性	说明
name	必需的属性。 要添加的协议的名称。

name 属性

值	说明
HttpGet	添加 HTTP GET 协议。 方法参数将被传入追加到 HTTP 请求 URL 的查询字符串中，其格式为 ?name1=value1&name2=value2…。 返回值将作为简单的 XML 文档（没有 <soap:Envelope>）放入 HTTP 响应的正文中。
HttpPost	添加 HTTP POST 协议。 方法参数将被传入 HTTP 请求的正文中，其格式为 name1=value1&name2=value…。 返回值将作为简单的 XML 文档（没有 <soap:Envelope>）放入 HTTP 响应的正文中。
HttpSoap	添加 HTTP SOAP 协议。 SOAP 消息在 HTTP 请求的正文中发送；SOAP 响应在 HTTP 响应的正文中发送。
Documentation	添加特殊的 Documentation 协议。 当在启用了此协议的情况下直接请求 .asmx 页时，ASP.NET 会运行帮助器页以创建 HTML 文档页，该文档页将传递给发出请求的客户端。

子元素

无。

父元素

元素	说明
configuration	公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中的根元素。
system.web	为 ASP.NET 配置节指定根元素。 包含用于配置 ASP.NET Web 应用程序并控制这些应用程序的行为方式的各种配置元素。
webServices	控制使用 ASP.NET 部署的 Web 服务的设置以及运行在 .NET Framework 上的 Web 服务客户端的设置。
protocols	指定 ASP.NET Web 服务可用来接收从客户端发送来的请求数据和返回响应数据的协议。 协议可用来将请求数据与方法及其参数关联起来，以及将响应数据与方法及其返回值关联起来。

备注

所有四个可能的协议都使用 HTTP/1.1（超文本传输协议）作为其传输协议。 从字面上可以看出，HttpGet 和 HttpPost 协议值分别使用 HTTP 的 GET 和 POST 方法。 HttpSoap 值也使用 POST 方法，但不使用 HTML 表单使用的传统 HTTP POST 语义。

示例

下面的示例启用全部四个受支持的协议。

<configuration>
   <system.web>
      <webServices>
         <protocols>
            <add name="HttpSoap"/>
            <add name="HttpPost"/>
            <add name="HttpGet"/>
            <add name="Documentation"/>
         </protocols>
      </webServices>
   </system.web>
</configuration>

请参见

参考

<webServices> 元素
<protocols> 元素

其他资源

ASP.NET Settings Schema
使用 ASP.NET 创建的 XML Web Services 以及 XML Web Services 客户端

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