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

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

<webParts enableExport="true|false">
   <personalization...>...</personalization>
   <transformers>...</transformers >
</webParts>

屬性和項目

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

屬性

屬性

描述

enableExport

選擇性 Boolean 屬性。

啟用控制項資料至 XML 描述檔的匯出。

預設值是 false。

子項目

項目

描述

personalization

選擇性項目。

指定 Web 組件個人化提供者,並設定 Web 組件個人化授權。

transformers

選擇性項目。

定義 TransformerInfo 物件的集合。

父項目

項目

描述

configuration

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

system.web

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

備註

預設組態

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

<webParts>
  <personalization>
    <providers>
      <add connectionStringName="LocalSqlServer"
        name="AspNetSqlPersonalizationProvider" 
        type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider, System.Web, 
        Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
    </providers>

    <authorization>
      <deny users="*" verbs="enterSharedScope" />
      <allow users="*" verbs="modifyState" />
    </authorization>

  </personalization>

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

範例

下列範例示範如何以宣告方式指定 webParts 區段的值。

<webParts>
  <personalization defaultProvider="AspNetSqlPersonalizationProvider">
    <providers>
      <add name="AspNetSqlPersonalizationProvider"
        type="System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider"
        connectionStringName="LocalSqlServer" applicationName="/" />
    </providers>
    <authorization>
      <deny users="*" verbs="enterSharedScope" />
      <allow users="*" verbs="modifyState" />
    </authorization>
  </personalization>
</webParts>

提供者只能在應用程式層級定義。

項目資訊

組態區段處理常式

System.Web.Configuration.WebPartsSection

組態成員

SystemWebSectionGroup.WebParts

可設定的位置

Machine.config

根層次 Web.config

應用程式層級 Web.config

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

需求

IIS 6.0 版

.NET Framework 2.0 版

Visual Studio 2005

請參閱

工作

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

參考

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

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

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

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

WebPartsSection

WebPartsPersonalization

WebPartsPersonalizationAuthorization

System.Configuration

System.Web.Configuration

概念

ASP.NET Configuration Overview

Configuration Inheritance

Securing Configuration

其他資源

一般組態設定 (ASP.NET)

ASP.NET 組態設定

Configuring ASP.NET Applications

ASP.NET Configuration API