<protocols> 的 <add> 項目

本主題專門說明舊有技術。 應該使用下列建立 XML Web Service 及 XML Web Service 用戶端： Windows Communication Foundation.

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

結構描述階層

<configuration>
  <system.web>
    <webServices> 項目
      <protocols> 項目
        <protocols> 的 <add> 項目

語法

<add name="protocol name"/>

屬性和元素

下列章節會說明屬性 (Attribute)、子項目和父項目。

屬性

屬性	描述
name	必要屬性。 要新增的通訊協定名稱。

項目子系

無。

父項目

項目	描述
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