PersonalizationProvider.DetermineInitialScope メソッド

定義

初期パーソナル化スコープが、Shared スコープと User スコープのどちらであるかを判断します。

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.PersonalizationScope
Public Overridable Function DetermineInitialScope (webPartManager As WebPartManager, loadedState As PersonalizationState) As PersonalizationScope

パラメーター

webPartManager
WebPartManager

パーソナル化情報を管理する WebPartManager

loadedState
PersonalizationState

パーソナル化状態情報。

戻り値

現在のパーソナル化スコープが PersonalizationScopeUser のどちらであるかを示す Shared

例外

webPartManagernullです。

webPartManager に関連付けられているページが null です。

注釈

このメソッドは、コントロールへの参照と、パーソナル化ライフ サイクルの前半から既に読み込まれているパーソナル化状態情報をWebPartManager指定して、現在のスコープSharedを または Userにするかどうかを決定します。 この情報は、後続の WebPartPersonalization パーソナル化関連タスクのために インスタンスによって使用されます。

パーソナル化スコープを決定するには、次の規則が使用されます。

  • スコープは、最初は であると見なされます User

  • 現在実行中のユーザー アカウントが認証されていない場合、スコープは に Shared設定されます。

  • 現在実行中のユーザー アカウントが認証されている場合は、優先順位に従って追加の処理が行われます。

    • ページがポストバック モードの場合、ページ要求には、ページの以前のレンダリングからのスコープ情報が含まれます。 そのスコープ情報がスコープが Shared 使用されたことを示している場合、スコープは に Shared評価されます。

    • 現在実行中のページが別のページからコントロールに転送された場合 (たとえば、 メソッドの呼び出しTransferによって制御の転送が発生した場合は 、この特定のチェックはページ間の投稿には発生しないことに注意してください)、以前に実行しているページにインスタンスがあるWebPartManager場合、スコープは前WebPartManagerのインスタンスのプロパティのPersonalization.Scope値に設定されます。

    • 前の条件が満たされていない場合、スコープは現在WebPartManagerのコントロールの プロパティのInitialScope値に評価されます。

前の評価が行われた後、スコープがスコープと Shared 評価されると、次の処理が行われます。

  • 現在実行中のユーザー アカウントに EnterSharedScopeUserCapability 機能がある場合、スコープは に Shared設定されたままです。

  • 現在実行中のユーザー アカウントに機能がない EnterSharedScopeUserCapability 場合、スコープは に Userリセットされます。

  • 以前のすべてのスコープ評価の結果が の場合、 Sharedこの結果は現在実行中のページの非表示フィールドとして格納されます。 これは、後続のポストバック中にページがスコープの評価を再生できるメカニズムです。

適用対象