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