PersonalizationProvider クラス

.NET Framework クラス ライブラリ リファレンス

PersonalizationProvider クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

パーソナル化プロバイダの基本機能を実装します。

名前空間: System.Web.UI.WebControls.WebParts
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public MustInherit Class
 PersonalizationProvider
    Inherits ProviderBase

Visual Basic (使用法)

Dim instance As PersonalizationProvider

C#

public abstract class PersonalizationProvider
 : ProviderBase

C++

public ref class PersonalizationProvider abstract
 : public ProviderBase

J#

public abstract class PersonalizationProvider
 extends ProviderBase

JScript

public abstract class PersonalizationProvider
 extends ProviderBase

解説

これは、パーソナル化プロバイダに必要な機能を定義する抽象基本クラスです。パーソナル化プロバイダは、WebPartPersonalization インスタンスに代わってパーソナル化データの読み込みと格納を行います。

この基本クラスでは多くのメソッドの標準的な動作が定義されます。基になるデータ ストアを具体的に扱うメソッドだけが抽象メソッドに指定されています。これにより開発者は、WebPartPersonalization クラスで使用される標準機能を再実装することなく、特定のデータ ストアと対話するカスタム プロバイダを作成できます。

継承時の注意 PersonalizationProvider から派生して、このクラスで定義された抽象メソッドだけに実装を提供できます。抽象メソッドは、特に、物理的なデータ ストアとの間のデータの保存と読み込みと、データ ストアの管理に関係しています。カスタム プロバイダは、Shared データと User データを区別するパーソナル化情報を操作できる必要があります。また、プロバイダは、パーソナル化データをページおよびアプリケーションによって区別する必要があります。 一部のパーソナル化プロバイダのメソッドは PersonalizationState 派生クラスのインスタンスを返すため、PersonalizationProvider の実装は PersonalizationState の実装と密に結合されています。カスタム プロバイダの開発を容易にするため、PersonalizationProvider 基本クラスには、パーソナル化ロジックの既定の実装と WebPartPersonalization クラスによって直接使用されるシリアル化/逆シリアル化のロジックが含まれています。そのため、単に異なるデータ ストアを使用する目的で作成するカスタム プロバイダには、次の抽象メソッド以外は実装する必要がありません。

• GetCountOfState : このメソッドでは、指定したクエリ パラメータで、データベース内のパーソナル化データの行数をカウントできる必要があります。

• LoadPersonalizationBlobs : このメソッドは、パスおよびユーザー名を与えられると、データベースから 2 つの BLOB を読み込みます。1 つは共有データの BLOB で、もう 1 つはユーザー データの BLOB です。ユーザー名およびパスを指定した場合、ユーザー名とパスの情報が提供されるページ情報に WebPartManager コントロールでアクセスする必要はありません。

• ResetPersonalizationBlob : このメソッドは、パスおよびユーザー名を与えられると、データベース内の対応する行を削除します。ユーザー名およびパスを指定した場合、ユーザー名とパスの情報が提供されるページ情報に WebPartManager コントロールでアクセスする必要はありません。

• SavePersonalizationBlob : このメソッドは、パスおよびユーザー名を与えられると、指定された BLOB をデータベースに保存します。ユーザー名およびパスを指定した場合、ユーザー名とパスの情報が提供されるページ情報に WebPartManager コントロールでアクセスする必要はありません。

これらのすべてのメソッドで、パスだけが指定される場合は、ページの共有パーソナル化データが有効になっていることを示します。パスとユーザー名の両方がメソッドに渡される場合は、ページのユーザー パーソナル化データが有効にされる必要があります。LoadPersonalizationBlobs の場合、常に、指定したパスの共有データが読み込まれます。また、ユーザー名が null 参照 (Visual Basic では Nothing) でない場合には、必要に応じて、そのパスのユーザー パーソナル化データも読み込まれます。 その他のすべての抽象メソッドは、管理アプリケーションのみで使用されるように設計されており、実行時に Web パーツのインフラストラクチャで使用されることはありません。パーソナル化プロバイダの実装例については、SqlPersonalizationProvider クラスのトピックを参照してください。

.NET Framework のセキュリティ

• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : LinkDemand; アクセス許可値 : Minimal。
• AspNetHostingPermission  (ホスト環境での動作に必要なアクセス許可)要求値 : InheritanceDemand; アクセス許可値 : Minimal。

継承階層

System.Object
   System.Configuration.Provider.ProviderBase
    System.Web.UI.WebControls.WebParts.PersonalizationProvider
       System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
PersonalizationProvider メンバ
System.Web.UI.WebControls.WebParts 名前空間
SqlPersonalizationProvider
その他の技術情報
ASP.NET Web パーツ ページ
Web パーツのパーソナル化の概要
チュートリアル : ユーザー コントロールに Web パーツ パーソナル化を実装する
Web パーツのパーソナル化