PersonalizationProvider.LoadPersonalizationState メソッド

定義

名前空間:

System.Web.UI.WebControls.WebParts

アセンブリ:

System.Web.dll

基になるデータ ストアから生のデータを読み込み、そのデータを PersonalizationState オブジェクトに変換します。

public:
 virtual System::Web::UI::WebControls::WebParts::PersonalizationState ^ LoadPersonalizationState(System::Web::UI::WebControls::WebParts::WebPartManager ^ webPartManager, bool ignoreCurrentUser);

public virtual System.Web.UI.WebControls.WebParts.PersonalizationState LoadPersonalizationState (System.Web.UI.WebControls.WebParts.WebPartManager webPartManager, bool ignoreCurrentUser);

abstract member LoadPersonalizationState : System.Web.UI.WebControls.WebParts.WebPartManager * bool -> System.Web.UI.WebControls.WebParts.PersonalizationState
override this.LoadPersonalizationState : System.Web.UI.WebControls.WebParts.WebPartManager * bool -> System.Web.UI.WebControls.WebParts.PersonalizationState

Public Overridable Function LoadPersonalizationState (webPartManager As WebPartManager, ignoreCurrentUser As Boolean) As PersonalizationState

パラメーター

webPartManager

WebPartManager

パーソナル化データを管理している WebPartManager。

ignoreCurrentUser

Boolean

そのユーザー名がパーソナル化プロバイダーに渡される必要があるかどうかを示している Boolean。

戻り値

PersonalizationState

パーソナル化データを格納している PersonalizationState。

例外

ArgumentNullException

webPartManager が null です。

ArgumentException

webPartManager に関連付けられているページが null です。

• または - ページに関連付けられている要求が null です。

注釈

このメソッドは、 WebPartPersonalization パーソナル化データを読み込むためにクラスによって使用されるメインエントリポイントです。 既定の実装は、基になるデータストアから生データを読み込み (派生プロバイダーで機能が実装されます)、その後、生データをインスタンスに変換し PersonalizationState ます。

ignoreCurrentUserパラメーターがの場合 true 、ユーザー名はメソッドに渡されません LoadPersonalizationBlobs 。 パーソナル化プロバイダーは、スコープを持つパーソナル化状態のみを Shared 基になるデータストアから取得するという意味で、これを解釈することを選択できます。

Loadメソッドが実行されると、メソッドが呼び出され LoadPersonalizationState ます。状態が読み込まれるときに発生する可能性がある逆シリアル化エラーには、3つの種類があります。 これらの特定のエラーが発生すると、例外はスローされず、正常性の監視機能によってエラーイベントがログに記録されます (正常性の監視とそれによって作成されたログへのアクセスについては、「 ASP.NET の正常性監視の概要」を参照してください)。 次の3つのシナリオでは、シリアル化解除エラーイベントがログに書き込まれます。

• 文字列を使用するプロパティの型を逆シリアル化しようとしましたが、失敗しました TypeConverter 。

• バイナリシリアル化を使用するプロパティ型を逆シリアル化しようとしましたが、失敗しました。

• 型のインスタンスを作成できないため、プロパティ型の逆シリアル化に失敗しました。