共用方式為

<soapExtensionTypes> 的 <add> 項目

  • 發行項

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

新增指定的 SOAP 擴充類別，以提供 Web 服務或用戶端 SOAP 訊息的延伸處理。

結構描述階層

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

語法

<add type="fully qualified type name [,Version=version number] [,Culture=culture] [,PublicKeyToken= token]"
   priority="number"
   group="0|1"/>

屬性和元素

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

屬性

屬性 說明

type

必要屬性。

指定要新增的 SOAP 擴充類別。type 屬性值必須在單行，且包括完整型別名稱。當組件置於全域組件快取 (GAC) 中時，也必須包含簽署組件的版本、文化特性和公開金鑰語彙基元。

priority

必要屬性。

連同 group，指定當設定執行多重 SOAP 擴充時執行 SOAP 擴充的相對順序。在各 group 中，priority 屬性可辨別 SOAP 擴充的整體相對優先權。較低的 priority 編號表示 SOAP 擴充有較高的優先權。priority 屬性可能的最小值為 1。

group

必要屬性。

  • 連同 priority，指定當設定執行多重 SOAP 擴充時執行 SOAP 擴充的相對順序。

項目子系

無。

父項目

項目 說明

configuration

Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中的根項目。

soapExtensionTypes

指定 SOAP 擴充功能，以在 Web 服務或用戶端上處理時，檢查或修改 SOAP 訊息。SOAP 擴充功能可以擴充 Web 服務的功能。

system.web

指定 ASP.NET 組態區段的根項目。

webServices

控制使用 ASP.NET 部署的 Web 服務設定，以及在 .NET Framework 上執行之 Web 服務用戶端的設定。

範例

下列範例會新增 SOAP 擴充類別。請注意，型別值必須在同一行。

<configuration>
   <system.web>
      <webServices>
         <soapExtensionTypes>
            <add type="Contoso.Extensions.MySoapExtension, Version=2.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"  priority="2" group="0"/>
         </soapExtensionTypes>
      </webServices>
   </system.web>
</configuration>

另請參閱

參考

<webServices> 項目
<soapExtensionTypes> 項目
SoapExtension

概念

使用 SOAP 擴充功能修改 SOAP 訊息

其他資源

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