PersonalizationProvider クラス

リファレンス

定義

名前空間:: System.Web.UI.WebControls.WebParts

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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

継承: Object

ProviderBase
PersonalizationProvider

派生: System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider

注釈

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

基底クラスは、いくつかのメソッドの標準動作を定義します。基になるデータストアを特に処理するメソッドのみが抽象としてマークされます。これにより、開発者は、クラスで使用される標準機能を再実装することなく、特定のデータストアと対話するカスタムプロバイダーを WebPartPersonalization 作成できます。

注意 (実装者)

から PersonalizationProvider 派生し、このクラスで定義されている抽象メソッドに対してのみ実装を提供できます。抽象メソッドでは、特に、物理データストアへのデータの保存と読み込み、およびデータストアの管理が行われます。カスタムプロバイダーは、データとUserデータを区別Sharedする方法でパーソナル化情報を操作できる必要があります。さらに、プロバイダーは、ページ別およびアプリケーション別にパーソナル化データをセグメント化する必要があります。

一部の 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)

メソッド

CreateSupportedUserCapabilities()	Web パーツコントロールセットによって使用される一連の既知の機能を表す WebPartUserCapability オブジェクトのリストを返します。
DetermineInitialScope(WebPartManager, PersonalizationState)	初期パーソナル化スコープが、Shared スコープと User スコープのどちらであるかを判断します。
DetermineUserCapabilities(WebPartManager)	現在実行中のユーザーアカウントのパーソナル化関連機能を表す WebPartUserCapability のインスタンスが含まれているディクショナリを返します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
FindState(PersonalizationScope, PersonalizationStateQuery, Int32, Int32, Int32)	派生クラスでオーバーライドされると、スコープおよび固有のクエリパラメーターに基づき 0 個以上の PersonalizationStateInfo 派生オブジェクトが含まれているコレクションを返します。
GetCountOfState(PersonalizationScope, PersonalizationStateQuery)	派生クラスでオーバーライドされると、指定したスコープ内に存在する基になるデータストア内の行数を返します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
Initialize(String, NameValueCollection)	構成ビルダーを初期化します。 (継承元 ProviderBase)
LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[])	派生クラス内でオーバーライドされると、基になるデータストアから生のパーソナル化データを読み込みます。
LoadPersonalizationState(WebPartManager, Boolean)	基になるデータストアから生のデータを読み込み、そのデータを PersonalizationState オブジェクトに変換します。
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ResetPersonalizationBlob(WebPartManager, String, String)	派生クラス内でオーバーライドされると、基になるデータストアから生のパーソナル化データを削除します。
ResetPersonalizationState(WebPartManager)	パーソナル化データを基になるデータストアの状態にリセットします。
ResetState(PersonalizationScope, String[], String[])	派生クラス内でオーバーライドされると、指定したパラメーターに基づいて、基になるデータストアからパーソナル化状態が削除されます。
ResetUserState(String, DateTime)	派生クラス内でオーバーライドされると、指定したパラメーターに基づいて、Web パーツパーソナル化データが基になるデータストアから削除されます。
SavePersonalizationBlob(WebPartManager, String, String, Byte[])	派生クラス内でオーバーライドされると、基になるデータストアに生のパーソナル化データを保存します。
SavePersonalizationState(PersonalizationState)	パーソナル化データをデータストアに保存します。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

適用対象

次の方法で共有