<protocols> 的 <add> 項目

加入指定的通訊協定，讓 ASP.NET Web 服務可藉以接收從用戶端傳來的要求資料並傳回回應資料。一種通訊協定，可使要求資料和方法及其參數之間產生關聯，以及使回應資料和方法及其傳回值之間產生關聯。

<configuration> 項目
  system.web 項目 (ASP.NET 設定結構描述)
    <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 將執行 Helper 網頁以建立文件 HTML 網頁，而該文件 HTML 網頁會傳送給提出要求的用戶端。

子項目

無

父項目

項目	說明
configuration	Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中的根項目。
system.web	指定 ASP.NET 組態區段的根項目。包含設定 ASP.NET Web 應用程式和控制該應用程式行為方式的組態項目。
webServices	控制使用 ASP.NET 部署的 Web Service 設定，以及在 .NET Framework 上執行的 Web Service 用戶端的設定。
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 組態設定
使用 ASP.NET 和 XML Web Service 用戶端建立的 XML Web Service
ASP.NET Configuration