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を使用するプロパティ型を逆シリアル化できませんでした。

  • バイナリ シリアル化を使用するプロパティ型を逆シリアル化できませんでした。

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

適用対象