webParts の personalization 要素 (ASP.NET 設定スキーマ)
[このドキュメントはプレビューのみを目的としており、以降のリリースで変更される可能性があります。プレースホルダーとして空白のトピックが含まれています。]
Web パーツ パーソナル化プロバイダーの指定、および Web パーツ パーソナル化承認の設定を行います。
<personalization defaultProvider="">
<authorization>...</authorization>
<providers>...</providers>
</personalization>
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
属性 |
Description |
|---|---|
defaultProvider |
省略可能な String 属性です。 既定の Web パーツ パーソナル化プロバイダーの名前を設定します。 既定値は "AspNetSqlPersonalizationProvider" です。 |
子要素
要素 |
Description |
|---|---|
authorization |
省略可能な要素です。 現在の Web アプリケーションの Web パーツ パーソナル化承認を設定します。 |
providers |
省略可能な要素です。 現在の Web アプリケーションの Web パーツ パーソナル化プロバイダーを設定します。 |
親要素
要素 |
Description |
|---|---|
configuration |
共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルで必要なルート要素です。 |
system.web |
構成ファイル内に含まれる ASP.NET の構成設定のルート要素を指定します。 ASP.NET Web アプリケーションを設定し、アプリケーションの動作方法を制御する構成要素を格納します。 |
webParts |
Web パーツ パーソナル化プロバイダーの指定やパーソナル化承認の設定ができる他、Web パーツの接続によって使用される WebPartTransformer クラスを拡張したカスタム クラスを追加できます。 |
解説
既定の構成
次の既定の personalization 要素は、.NET Framework Version 2.0 においてルートの Web.config ファイルで構成されています。
<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>
使用例
ASP.NET アプリケーションのパーソナル化設定を構成する方法を次の例に示します。
<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>
プロバイダーは、アプリケーション レベルでのみ定義できます。 ただし、承認はローカル ディレクトリごとに定義できます。 したがって、この 2 つの要素を異なるスコープで定義する場合は、値が競合しないよう注意する必要があります。
要素情報
構成セクション ハンドラー |
|
構成メンバー |
|
構成できる場所 |
Machine.config ルート レベルの Web.config アプリケーション レベルの Web.config 仮想ディレクトリ レベルまたは物理ディレクトリ レベルの Web.config |
要件 |
IIS バージョン 5.0、IIS バージョン 5.1、およびバージョン 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 の authorization 要素 (ASP.NET 設定スキーマ)
webParts の personalization の providers 要素 (ASP.NET 設定スキーマ)
WebPartsPersonalizationAuthorization
概念
ASP.NET Configuration Overview