PersonalizationProvider.DetermineInitialScope メソッド

定義

名前空間:

System.Web.UI.WebControls.WebParts

アセンブリ:

System.Web.dll

初期パーソナル化スコープが、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

パーソナル化状態情報。

戻り値

PersonalizationScope

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

例外

ArgumentNullException

webPartManager が nullです。

ArgumentException

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

注釈

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

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

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

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

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

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

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

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

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

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

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

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