共用方式為


webParts 的 transformers 項目 (ASP.NET 設定結構描述)

定義 TransformerInfo 物件的集合。

<transformers>
    <add.../>
    <clear />
    <remove.../>
</transformers>

屬性和項目

下列各節將說明屬性、子項目和父項目。

屬性

無。

子項目

項目

描述

add

選擇性 String 項目。

Transformers 物件加入至集合。

clear

選擇性 String 項目。

從集合中移除所有 transformers 物件。

remove

選擇性 String 項目。

從集合中移除指定的 transformers 物件。

父項目

項目

說明

configuration

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

system.web

針對組態檔中的 ASP.NET 組態設定指定根項目。 包含設定 ASP.NET Web 應用程式和控制該應用程式行為方式的組態項目。

webParts

可讓您指定 Web 組件個人化提供者、設定個人化授權,以及加入可擴充 Transformer 類別供 Web 組件連線使用的自訂類別。

備註

組態中指定的轉換程式是在判斷潛在動態連接之相容性時使用的轉換程式。 另外,只有可在靜態或動態頁面上使用的轉換程式才是組態中指定的轉換程式。

預設的組態

下列預設 transformers 項目已在 .NET Framework 2.0 版中的根目錄 Web.config 檔中設定。

<transformers>
  <add name="RowToFieldTransformer" 
    type="System.Web.UI.WebControls.WebParts.RowToFieldTransformer" />
  <add name="RowToParametersTransformer" 
    type="System.Web.UI.WebControls.WebParts.RowToParametersTransformer" />
</transformers>

範例

下列範例會為 ASP.NET 應用程式設定 transformers。

<webParts>
  <transformers>
    <clear />
      <remove name="RowToKeysTransformer" />
      <add name="RowToFieldTransformer"
        type="System.Web.UI.WebControls.WebParts.RowToFieldTransformer" />
      <add name="RowToFilterTransformer"
        type="System.Web.UI.WebControls.WebParts.RowToFilterTransformer" />
      <add name="RowToParametersTransformer"
        type="System.Web.UI.WebControls.WebParts.RowToParametersTransformer" />
  </transformers>
</webParts>

項目資訊

組態區段處理常式

System.Web.Configuration.WebPartsSection

組態成員

WebPartsSection.Transformers

可設定的位置

Machine.config

根層次 Web.config

應用程式層級 Web.config

虛擬或實體目錄層級 Web.config

需求

IIS 6.0

.NET Framework 2.0

Visual Studio 2005

請參閱

工作

HOW TO:使用位置設定來設定特定的目錄

HOW TO:鎖定 ASP.NET 組態設定

參考

system.web 項目 (ASP.NET 設定結構描述)

configuration 項目 (一般設定結構描述)

webParts 項目 (ASP.NET 設定結構描述)

webParts 之 transformers 的 add 項目 (ASP.NET 設定結構描述)

webParts 之 transformers 的 clear 項目 (ASP.NET 設定結構描述)

webParts 之 transformers 的 remove 項目 (ASP.NET 設定結構描述)

System.Configuration

System.Web.Configuration

概念

ASP.NET 組態檔階層架構和繼承

保護 ASP.NET 組態

ASP.NET 組態案例

其他資源

一般組態設定 (ASP.NET)

ASP.NET 組態設定

ASP.NET 網站管理

ASP.NET 組態檔

ASP.NET 組態 API