PersonalizationProvider.DetermineInitialScope メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
public:
virtual System::Web::UI::WebControls::WebParts::PersonalizationScope DetermineInitialScope(System::Web::UI::WebControls::WebParts::WebPartManager ^ webPartManager, System::Web::UI::WebControls::WebParts::PersonalizationState ^ loadedState);public virtual System.Web.UI.WebControls.WebParts.PersonalizationScope DetermineInitialScope (System.Web.UI.WebControls.WebParts.WebPartManager webPartManager, System.Web.UI.WebControls.WebParts.PersonalizationState loadedState);abstract member DetermineInitialScope : System.Web.UI.WebControls.WebParts.WebPartManager * System.Web.UI.WebControls.WebParts.PersonalizationState -> System.Web.UI.WebControls.WebParts.PersonalizationScope
override this.DetermineInitialScope : System.Web.UI.WebControls.WebParts.WebPartManager * System.Web.UI.WebControls.WebParts.PersonalizationState -> System.Web.UI.WebControls.WebParts.PersonalizationScopePublic Overridable Function DetermineInitialScope (webPartManager As WebPartManager, loadedState As PersonalizationState) As PersonalizationScopeパラメーター
- webPartManager
- WebPartManager
パーソナル化情報を管理する WebPartManager。
- loadedState
- PersonalizationState
パーソナル化状態情報。
戻り値
現在のパーソナル化スコープが PersonalizationScope と User のどちらであるかを示す Shared。
例外
webPartManager が nullです。
webPartManager に関連付けられているページが null です。
注釈
このメソッドは、コントロールへの参照と、パーソナル化ライフ サイクルの前半から既に読み込まれているパーソナル化状態情報をWebPartManager指定して、現在のスコープSharedを または Userにするかどうかを決定します。 この情報は、後続の WebPartPersonalization パーソナル化関連タスクのために インスタンスによって使用されます。
パーソナル化スコープを決定するには、次の規則が使用されます。
スコープは、最初は であると見なされます User。
現在実行中のユーザー アカウントが認証されていない場合、スコープは に Shared設定されます。
現在実行中のユーザー アカウントが認証されている場合は、優先順位に従って追加の処理が行われます。
ページがポストバック モードの場合、ページ要求には、ページの以前のレンダリングからのスコープ情報が含まれます。 そのスコープ情報がスコープが Shared 使用されたことを示している場合、スコープは に Shared評価されます。
現在実行中のページが別のページからコントロールに転送された場合 (たとえば、 メソッドの呼び出しTransferによって制御の転送が発生した場合は 、この特定のチェックはページ間の投稿には発生しないことに注意してください)、以前に実行しているページにインスタンスがあるWebPartManager場合、スコープは前WebPartManagerのインスタンスのプロパティの
Personalization.Scope値に設定されます。前の条件が満たされていない場合、スコープは現在WebPartManagerのコントロールの プロパティのInitialScope値に評価されます。
前の評価が行われた後、スコープがスコープと Shared 評価されると、次の処理が行われます。
現在実行中のユーザー アカウントに EnterSharedScopeUserCapability 機能がある場合、スコープは に Shared設定されたままです。
現在実行中のユーザー アカウントに機能がない EnterSharedScopeUserCapability 場合、スコープは に Userリセットされます。
以前のすべてのスコープ評価の結果が の場合、 Sharedこの結果は現在実行中のページの非表示フィールドとして格納されます。 これは、後続のポストバック中にページがスコープの評価を再生できるメカニズムです。
適用対象
.NET