PersonalizationProvider クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
パーソナル化プロバイダーの基本機能を実装します。
public ref class PersonalizationProvider abstract : System::Configuration::Provider::ProviderBase
public abstract class PersonalizationProvider : System.Configuration.Provider.ProviderBase
type PersonalizationProvider = class
inherit ProviderBase
Public MustInherit Class PersonalizationProvider
Inherits ProviderBase
- 継承
- 派生
注釈
これは、パーソナル化プロバイダーの必要な機能を定義する抽象基本クラスです。 パーソナル化プロバイダーは、インスタンスに代わってパーソナル化データを読み込み、格納 WebPartPersonalization します。
基本クラスは、多数のメソッドの標準的な動作を定義します。基になるデータ ストアを特に処理するメソッドだけが抽象としてマークされます。 これにより、開発者は、クラスで使用される標準機能を再実装することなく、特定のデータ ストアと対話するカスタム プロバイダーを作成 WebPartPersonalization できます。
注意 (実装者)
から派生し PersonalizationProvider 、このクラスで定義されている抽象メソッドについてのみ実装を提供できます。 抽象メソッドは、特に、物理データ ストアへのデータの保存と読み込み、およびデータ ストア管理に関する処理を行います。 カスタム プロバイダーは、データとデータを区別する方法でパーソナル化情報 Shared を操作できる必要 User があります。 さらに、プロバイダーは、ページ別およびアプリケーション別にパーソナル化データをセグメント化する必要があります。
の実装は、 の実装と緊密に結合されています。一部のパーソナル化プロバイダー メソッドは、派生クラスの PersonalizationProvider PersonalizationState PersonalizationState インスタンスを返します。 カスタム プロバイダーの開発を容易にするために、基本クラスには、パーソナル化ロジックの既定の実装と、 クラスによって直接使用されるシリアル化/逆シリアル化ロジック PersonalizationProvider が含 WebPartPersonalization まれています。 その結果、別のデータ ストアを操作する目的でのみカスタム プロバイダーを作成するには、次の抽象メソッドを実装する必要があります。
GetCountOfState(PersonalizationScope, PersonalizationStateQuery) - このメソッドは、指定されたクエリ パラメーターについて、データベース内のパーソナル化データの行数をカウントできる必要があります。
LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]) - パスとユーザー名を指定すると、このメソッドはデータベースから 2 つのバイナリ ラージ オブジェクト (BLOB) を読み込み、もう 1 つは共有データ用の BLOB、もう 1 つはユーザー データ用です。 ユーザー名とパスを指定する場合は、ユーザー名/パス情報を提供できるページ情報にアクセスするコントロール WebPartManager は必要ではありません。
ResetPersonalizationBlob(WebPartManager, String, String) - パスとユーザー名を指定すると、このメソッドはデータベース内の対応する行を削除します。 ユーザー名とパスを指定する場合は、ユーザー名/パス情報を提供できるページ情報にアクセスするコントロール WebPartManager は必要ではありません。
SavePersonalizationBlob(WebPartManager, String, String, Byte[]) - パスとユーザー名を指定すると、このメソッドは指定された BLOB をデータベースに保存します。 ユーザー名とパスを指定する場合は、ユーザー名/パス情報を提供できるページ情報にアクセスするコントロール WebPartManager は必要ではありません。
これらのメソッドのすべてで、パスだけが指定されている場合は、ページの共有パーソナル化データが操作されている状態を示します。 パスとユーザー名の両方がメソッドに渡される場合は、ページのユーザーパーソナル化データを処理する必要があります。 の場合、指定したパスの共有データを常に読み込む必要があります。また、必要に応じて、ユーザー名が ではない場合は、パスのユーザーパーソナル化データも読み込 LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]) む必要があります null
。
他のすべての抽象メソッドは、管理アプリケーションでのみ使用することを目的とし、実行時に Web パーツ インフラストラクチャで使用されません。 パーソナル化プロバイダーの実装の例については、 クラスを参照 SqlPersonalizationProvider してください。
コンストラクター
PersonalizationProvider() |
PersonalizationProvider クラスの新しいインスタンスを初期化します。 |
プロパティ
ApplicationName |
派生クラスでオーバーライドされると、プロバイダーに対して構成されたアプリケーションの名前を取得または設定します。 |
Description |
管理ツールまたは他のユーザー インターフェイス (UI) での表示に適した、簡単でわかりやすい説明を取得します。 (継承元 ProviderBase) |
Name |
構成時にプロバイダーを参照するために使用される表示名を取得します。 (継承元 ProviderBase) |