WebPartPersonalization.Load メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
パーソナル化を初期化します。
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.PersonalizationScopeProtected Overridable Function Load () As PersonalizationScope戻り値
親である PersonalizationScope の WebPartManager インスタンス。
例外
このメソッドはパーソナル化が無効な場合 (Enabled が false の場合) に呼び出されました。
- または -
関連する Page の WebPartManager プロパティの値が null です。
- または -
Request コントロールの関連する WebPartManager インスタンスの Page プロパティの値が null です。
プロバイダーが、ページ マークアップまたは ProviderName プロパティのいずれかで明示的に設定されましたが、そのプロバイダーは見つかりません。
- または -
パーソナル化状態データを格納するオブジェクトが null です。
既定のプロバイダーが見つからないか、パーソナル化プロバイダーの初期化を行う際にエラーが発生したため、基になるパーソナル化プロバイダーが初期化に失敗しました。
注釈
これは、親 WebPartManager コントロールに代わってパーソナル化情報を初期化するための主要なエントリ ポイントです。 このメソッドは、親 WebPartManager コントロール OnInit の メソッド中に呼び出されます。 通常、親 WebPartManager コントロールでパーソナル化が無効になっている場合、このメソッドは呼び出されません。
このメソッドの実行中に、次の初期化が行われます。
既定のパーソナル化プロバイダー、またはページ マークアップまたは プロパティに WebPartManager 示されているカスタム プロバイダーへの参照が ProviderName 取得されます。
プロバイダーが呼び出され、現在実行中のユーザーのユーザー機能 (DetermineUserCapabilities) が決定されます。
現在のページ/ユーザー/スコープの組み合わせのパーソナル化状態は、基になるデータ ストアからプロバイダー (LoadPersonalizationState) によって読み込まれ、インスタンス内に WebPartPersonalization 格納されます。
現在のページ/ユーザー/スコープのパーソナル化スコープは、プロバイダー (DetermineInitialScope) によって決定されます。 この決定の結果は、 プロパティの InitialScope 値とは異なる場合があることに注意してください。
このメソッドから返されるスコープ値は、 プロパティの値 Scope として使用されます。
注意
InvalidOperationExceptionパーソナル化が有効になっていないために例外が発生するのは、 メソッドがLoad直接呼び出された場合のみです。 ASP.NET 実装では、読み込みを実行するために内部ヘルパー メソッドが実際に呼び出され、ページに対してパーソナル化が有効になっていない場合、このヘルパー メソッドは自動的にを返します。
適用対象
こちらもご覧ください
.NET