PersonalizationProvider.DetermineInitialScope Metoda

Definice

Obor názvů:

System.Web.UI.WebControls.WebParts

Sestavení:

System.Web.dll

Určuje, zda má být Shared počáteční rozsah přizpůsobení nebo User obor.

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

Parametry

webPartManager

WebPartManager

Ten WebPartManager , který spravuje informace o přizpůsobení.

loadedState

PersonalizationState

Informace o stavu přizpůsobení.

Návraty

PersonalizationScope

A PersonalizationScope označující, jestli je User aktuální rozsah přizpůsobení nebo Shared.

Výjimky

ArgumentNullException

webPartManager je null.

ArgumentException

Přidružená stránka webPartManager je null.

Poznámky

Tato metoda určuje, zda aktuální rozsah má být Shared nebo User, s odkazem WebPartManager na ovládací prvek a informace o stavu přizpůsobení, které již byly načteny z dřívějšího životního cyklu přizpůsobení. Tyto informace používá instance pro následné úlohy související s přizpůsobením WebPartPersonalization .

K určení rozsahu přizpůsobení se používají následující pravidla:

• Předpokládá se, že obor je Userzpočátku .

• Pokud aktuálně spouštěný uživatelský účet není ověřený, je obor nastavený na Shared.

• Pokud je aktuálně spuštěný uživatelský účet ověřený, provede se další zpracování v pořadí podle priority:

  • Pokud je stránka v režimu zpětného vrácení, požadavek na stránku obsahuje informace o oboru z předchozího vykreslení stránky. Pokud informace o oboru značí, že Shared byl použit obor, vyhodnotí se obor jako Shared.

  • Pokud se na aktuálně spuštěnou stránku přenesl ovládací prvek z jiné stránky (například pokud k přenosu ovládacího prvku došlo kvůli volání Transfer metody; mějte na paměti, že tato konkrétní kontrola se neprovádí pro publikování na více stránkách) a pokud dříve spouštěná stránka měla WebPartManager instanci, je obor nastaven na hodnotu Personalization.Scope vlastnosti z předchozí WebPartManager instance.

  • Pokud předchozí kritéria nejsou splněna, rozsah se vyhodnotí jako hodnota InitialScope vlastnosti aktuálního WebPartManager ovládacího prvku.

Po provedení předchozích vyhodnocení a pokud se obor vyhodnotí jako Shared obor, proběhne následující zpracování:

• Pokud má EnterSharedScopeUserCapability aktuálně spouštěný uživatelský účet tuto funkci, zůstane obor nastavený na Sharedhodnotu .

• Pokud aktuálně spouštěný uživatelský účet tuto funkci nemá EnterSharedScopeUserCapability , pak se obor resetuje na User.

• Pokud je Sharedvýsledek všech předchozích vyhodnocení oboru , uloží se tento výsledek jako skryté pole na právě spuštěné stránce. Jedná se o mechanismus, který umožňuje, aby stránka přehrála vyhodnocení rozsahu během následných postbacků.