Web 服務設定結構描述

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

Web 服務設定結構描述會定義組態檔項目，而這些項目可以控制 ASP.NET Web 服務及它們用戶端的行為。父項目為 <webServices>。

根據預設，<webServices> 項目及它的子代 (Descendant) 會套用至組態套用的任何 Web 服務或 Proxy 類別。套用組態是依應用程式類型來套用，如下所示：

• ASP.NET Web 應用程式 (服務或用戶端)：如需有關用於 ASP.NET Web 應用程式中組態繼承、範圍設定和優先順序的標準規則，請參考 ASP.NET 組態檔階層架構和繼承。<webServices> 項目通常是放在 Web.config 檔中。

• 獨立 .NET Framework 應用程式 (僅限用戶端)：請參考應用程式組態檔。<webServices> 項目通常是放在應用程式組態檔中。

<webServices> 項目及它的子代會套用至下列幾種類別：

• 衍生自 WebService 的 Web 服務類別。

• 間接衍生自 WebClientProtocol 的用戶端 Proxy 類別。

<webServices> 項目可以套用至 Web 服務和用戶端，其中 Web 應用程式會同時包含這兩個實體 (Entity)。

<configuration>
   <system.web>
      <webServices>
         <protocols>
            <add>
            <remove>
            <clear>
         <serviceDescriptionFormatExtensionTypes>
            <add>
            <remove>
            <clear>
         <soapExtensionTypes>
            <add>
            <remove>
            <clear>
         <soapExtensionImporterTypes>
            <add>
            <remove>
            <clear>
         <soapExtensionReflectorTypes>
            <add>
            <remove>
            <clear>
         <wsdlHelpGenerator>

項目	描述
<protocols> 的 <add>	加入指定的通訊協定，讓 ASP.NET Web 服務可藉以接收從用戶端傳來的要求資料並傳回回應資料。
<serviceDescriptionFormatExtensionTypes> 的 <add>	新增指定的服務描述格式延伸 (SDFE) 類別，以定義如何擴充為 Web 服務產生的服務描述 (WSDL 文件)。
<soapExtensionTypes> 的 <add>	新增指定的 SOAP 擴充類別，以提供 Web 服務或用戶端 SOAP 訊息的延伸處理。
<soapExtensionImporterTypes> 的 <add>	新增指定的 SOAP 擴充匯入工具類別，以擴充用來與服務描述格式延伸 (SDFE) 搭配使用的用戶端 Proxy 產生處理序。
<soapExtensionReflectorTypes> 的 <add>	新增指定的 SOAP 擴充反映程式類別，以擴充用來與服務描述格式延伸 (SDFE) 搭配使用的服務描述 (WSDL 文件) 產生處理序。
<clear>	移除適用於父標記的項目的所有參考。
<protocols>	指定通訊協定，讓 ASP.NET Web 服務可藉以接收從用戶端傳來的要求資料並傳回回應資料。一種通訊協定，可使要求資料和方法及其參數之間產生關聯，以及使回應資料和方法及其傳回值之間產生關聯。
<protocols> 的 <remove>	從組態檔範圍內移除用於處理要求和回應資料之指定的通訊協定。
<serviceDescriptionFormatExtensionTypes> 的 <remove>	從組態檔範圍內移除指定的服務描述格式擴充功能 (SDFE) 類別。
<soapExtensionTypes> 的 <remove>	從組態檔範圍內移除指定的 SOAP 擴充類別。
<soapExtensionImporterTypes> 的 <remove>	從組態檔範圍內移除指定的 SOAP 擴充匯入工具類別。
<soapExtensionReflectorTypes> 的 <remove>	從組態檔範圍內移除指定的 SOAP 擴充反映程式類別。
<serviceDescriptionFormatExtensionTypes>	指定用來延伸為 Web 服務產生之 WSDL 文件的服務描述格式延伸 (Service Description Format Extension，SDFE) 類別。SDFE 類別會提供描述 SOAP 擴充功能的方法。
<soapExtensionImporterTypes>	指定 SOAP 擴充匯入工具類別，此類別會擴充用戶端 Proxy 產生處理序。搭配服務描述格式擴充功能 (SDFE) 使用。
<soapExtensionReflectorTypes>	指定 SOAP 擴充反映程式類別，以擴充服務描述 (WSDL 文件) 的產生處理序。搭配服務描述格式擴充功能 (SDFE) 使用。
<soapExtensionTypes>	指定 SOAP 擴充功能，以在 Web 服務或用戶端上處理時，檢查或修改 SOAP 訊息。SOAP 擴充功能可以擴充 Web 服務的功能。
<webServices>	控制使用 ASP.NET 部署的 Web 服務設定，以及在 .NET Framework 上執行之 Web 服務用戶端的設定。
<wsdlHelpGenerator>	指定當瀏覽器直接瀏覽至 ASMX Web 服務網頁時，瀏覽器顯示的 Web 服務說明網頁 (.aspx 檔案)。

另請參閱

其他資源

ASP.NET Settings Schema
使用 ASP.NET 和 XML Web Service 用戶端建立的 XML Web Service