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í obor 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

Tím WebPartManager se spravují osobní údaje.

loadedState

PersonalizationState

Informace o stavu přizpůsobení.

Návraty

PersonalizationScope

Určuje PersonalizationScope , zda je User aktuální rozsah přizpůsobení nebo Shared.

Výjimky

ArgumentNullException

webPartManager je null.

ArgumentException

Stránka přidružená webPartManager je null.

Poznámky

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

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

• Obor se předpokládá na začátku User.

• Pokud aktuálně spuš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ý, dojde k dalšímu zpracování v pořadí podle priority:

  • Pokud je stránka v režimu postback, požadavek na stránku obsahuje informace o oboru z předchozího vykreslování stránky. Pokud informace o oboru označují, že Shared byl obor použit, pak se rozsah vyhodnotí jako Shared.

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

  • Pokud předchozí kritéria nejsou splněna, vyhodnotí se obor na hodnotu vlastnosti aktuálního InitialScopeWebPartManager ovládacího prvku.

Po provedení předchozích vyhodnocení a pokud se rozsah vyhodnotí jako Shared obor, dojde k následujícímu zpracování:

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

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

• Pokud je Sharedvýsledkem všech předchozích vyhodnocení oboru, uloží se tento výsledek jako skryté pole na aktuálně spuštěné stránce. Toto je mechanismus, kdy může stránka během následných zpětného odeslání znovu přehrát vyhodnocení oboru.