次の方法で共有

WebPartPersonalization.Load メソッド

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls.WebParts
アセンブリ:
System.Web.dll

パーソナル化を初期化します。

protected:
 virtual System::Web::UI::WebControls::WebParts::PersonalizationScope Load();
protected virtual System.Web.UI.WebControls.WebParts.PersonalizationScope Load ();
abstract member Load : unit -> System.Web.UI.WebControls.WebParts.PersonalizationScope
override this.Load : unit -> System.Web.UI.WebControls.WebParts.PersonalizationScope
Protected Overridable Function Load () As PersonalizationScope

戻り値

PersonalizationScope

親である PersonalizationScope の WebPartManager インスタンス。

例外

InvalidOperationException

このメソッドはパーソナル化が無効な場合 (Enabled が false の場合) に呼び出されました。

- または -

関連する Page の WebPartManager プロパティの値が null です。

- または -

Request コントロールの関連する WebPartManager インスタンスの Page プロパティの値が null です。

ProviderException

プロバイダーが、ページ マークアップまたは ProviderName プロパティのいずれかで明示的に設定されましたが、そのプロバイダーは見つかりません。

- または -

パーソナル化状態データを格納するオブジェクトが null です。

ArgumentException

データの読み込み中または逆シリアル化中に問題が発生しました。

- または -

構成ファイルのパーソナル化プロバイダーの定義でエラーが発生しました。

ConfigurationErrorsException

既定のプロバイダーが見つからないか、パーソナル化プロバイダーの初期化を行う際にエラーが発生したため、基になるパーソナル化プロバイダーが初期化に失敗しました。

注釈

これは、親 WebPartManager コントロールに代わってパーソナル化情報を初期化するための主要なエントリ ポイントです。 このメソッドは、親 WebPartManager コントロール OnInit の メソッド中に呼び出されます。 通常、親 WebPartManager コントロールでパーソナル化が無効になっている場合、このメソッドは呼び出されません。

このメソッドの実行中に、次の初期化が行われます。

  • 既定のパーソナル化プロバイダー、またはページ マークアップまたは プロパティに WebPartManager 示されているカスタム プロバイダーへの参照が ProviderName 取得されます。

  • プロバイダーが呼び出され、現在実行中のユーザーのユーザー機能 (DetermineUserCapabilities) が決定されます。

  • 現在のページ/ユーザー/スコープの組み合わせのパーソナル化状態は、基になるデータ ストアからプロバイダー (LoadPersonalizationState) によって読み込まれ、インスタンス内に WebPartPersonalization 格納されます。

  • 現在のページ/ユーザー/スコープのパーソナル化スコープは、プロバイダー (DetermineInitialScope) によって決定されます。 この決定の結果は、 プロパティの InitialScope 値とは異なる場合があることに注意してください。

このメソッドから返されるスコープ値は、 プロパティの値 Scope として使用されます。

注意

InvalidOperationExceptionパーソナル化が有効になっていないために例外が発生するのは、 メソッドがLoad直接呼び出された場合のみです。 ASP.NET 実装では、読み込みを実行するために内部ヘルパー メソッドが実際に呼び出され、ページに対してパーソナル化が有効になっていない場合、このヘルパー メソッドは自動的にを返します。

適用対象

こちらもご覧ください