Share via


webParts 要素 (ASP.NET 設定スキーマ)

Web パーツ パーソナル化プロバイダーの指定やパーソナル化承認の設定ができる他、Web パーツの接続によって使用される WebPartTransformer クラスを拡張したカスタム クラスを追加できます。

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

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性

説明

enableExport

省略可能な Boolean 型の属性です。

コントロールのデータを XML 記述ファイルにエクスポートできるようにします。

既定値は false です。

子要素

要素

説明

personalization

省略可能な要素です。

Web パーツ パーソナル化プロバイダーの指定、および Web パーツ パーソナル化承認の設定を行います。

transformers

省略可能な要素です。

TransformerInfo オブジェクトのコレクションを定義します。

親要素

要素

説明

configuration

共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルで必要なルート要素です。

system.web

構成ファイル内に含まれる ASP.NET の構成設定のルート要素を指定します。 ASP.NET Web アプリケーションを設定し、アプリケーションの動作方法を制御する構成要素を格納します。

解説

既定の構成

次の既定の webParts 要素は、.NET Framework Version 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 Version 2.0

Visual Studio 2005

参照

処理手順

方法 : Location の設定を使用して特定のディレクトリを構成する

方法 : ASP.NET 構成設定をロックする

参照

system.web 要素 (ASP.NET 設定スキーマ)

configuration 要素 (全般設定スキーマ)

webParts の personalization 要素 (ASP.NET 設定スキーマ)

webParts の transformers 要素 (ASP.NET 設定スキーマ)

WebPartsSection

WebPartsPersonalization

WebPartsPersonalizationAuthorization

System.Configuration

System.Web.Configuration

概念

ASP.NET 構成の概要

ASP.NET の構成のシナリオ

ASP.NET 構成の保護

その他の技術情報

全般構成設定 (ASP.NET)

ASP.NET 構成設定

ASP.NET Web サイト管理

ASP.NET 構成 API