Web 服務設定結構描述

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

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

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

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

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

<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 Service 設定,以及在 .NET Framework 上執行的 Web Service 用戶端的設定。

<wsdlHelpGenerator>

指定當瀏覽器直接瀏覽至 ASMX Web 服務網頁時,瀏覽器顯示的 Web 服務說明網頁 (.aspx 檔案)。

請參閱

其他資源

ASP.NET 組態設定
使用 ASP.NET 和 XML Web Service 用戶端建立的 XML Web Service
ASP.NET Configuration