共用方式為

<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 通訊協定。當啟用這個通訊協定且直接要求 .asmx 網頁時，ASP.NET 將執行服務說明網頁以建立會傳送給要求用戶端的文件 HTML 網頁。

子項目

無。

父項目

項目 描述

configuration

Common Language Runtime 和 .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 語意 (Semantics)。

範例

下列範例會啟用所有支援的四個通訊協定。

<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 Service 用戶端建立的 XML Web Service

Footer image

Copyright © 2007 by Microsoft Corporation. All rights reserved.