webParts 要素 (ASP.NET 設定スキーマ)
[このドキュメントはプレビューのみを目的としており、以降のリリースで変更される可能性があります。プレースホルダーとして空白のトピックが含まれています。]
Web パーツ パーソナル化プロバイダーの指定やパーソナル化承認の設定ができる他、Web パーツの接続によって使用される WebPartTransformer クラスを拡張したカスタム クラスを追加できます。
<webParts enableExport="true|false">
<personalization...>...</personalization>
<transformers>...</transformers >
</webParts>
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
属性 |
Description |
|---|---|
enableExport |
省略可能な Boolean 型の属性です。 コントロールのデータを XML 記述ファイルにエクスポートできるようにします。 既定値 false です。 |
子要素
要素 |
Description |
|---|---|
personalization |
省略可能な要素です。 Web パーツ パーソナル化プロバイダーの指定、および Web パーツ パーソナル化承認の設定を行います。 |
transformers |
省略可能な要素です。 TransformerInfo オブジェクトのコレクションを定義します。 |
親要素
要素 |
Description |
|---|---|
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>
プロバイダーは、アプリケーション レベルでのみ定義できます。
要素情報
構成セクション ハンドラー |
|
構成メンバー |
|
構成できる場所 |
Machine.config ルート レベルの Web.config アプリケーション レベルの Web.config 仮想ディレクトリ レベルまたは物理ディレクトリ レベルの Web.config |
要件 |
IIS バージョン 6.0 .NET Framework Version 2.0 Visual Studio 2005 |
参照
処理手順
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
Reference
system.web 要素 (ASP.NET 設定スキーマ)
webParts の personalization 要素 (ASP.NET 設定スキーマ)
webParts の transformers 要素 (ASP.NET 設定スキーマ)
WebPartsPersonalizationAuthorization
概念
ASP.NET Configuration Overview