WebPartPersonalization.Load Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Inicializuje přizpůsobení.
protected:
virtual System::Web::UI::WebControls::WebParts::PersonalizationScope Load();
protected virtual System.Web.UI.WebControls.WebParts.PersonalizationScope Load ();
abstract member Load : unit -> System.Web.UI.WebControls.WebParts.PersonalizationScope
override this.Load : unit -> System.Web.UI.WebControls.WebParts.PersonalizationScope
Protected Overridable Function Load () As PersonalizationScope
Návraty
Instance PersonalizationScope nadřazeného WebPartManagerobjektu .
Výjimky
Tato metoda se volá, když není povolené přizpůsobení (Enabled rovná se false
).
-nebo-
Hodnota Page vlastnosti přidruženého WebPartManager objektu je null
.
-nebo-
Hodnota Request vlastnosti v přidružené Page instanci ovládacího prvku je null
WebPartManager .
Zprostředkovatel byl explicitně nastaven buď ve značce stránky, nebo ve ProviderName vlastnosti a zprostředkovatel nebyl nalezen.
-nebo-
Objekt obsahující data o stavu přizpůsobení je null
.
Při načítání a deserializaci dat došlo k problému.
-nebo-
V definici zprostředkovatele přizpůsobení v konfiguračním souboru došlo k chybě.
Zprostředkovatelé základního přizpůsobení se nepodařilo inicializovat, protože se nepodařilo najít výchozího zprostředkovatele nebo došlo k chybě při pokusu o inicializaci zprostředkovatele přizpůsobení.
Poznámky
Toto je hlavní vstupní bod pro inicializaci informací o přizpůsobení jménem nadřazeného WebPartManager ovládacího prvku. Tato metoda je volána během metody nadřazeného WebPartManagerOnInit ovládacího prvku. Za normálních okolností, pokud je v nadřazené WebPartManager ovládací prvek zakázáno přizpůsobení, nebude tato metoda nikdy volána.
V průběhu této metody dochází k následujícím inicializacím:
Získá se odkaz buď na výchozího zprostředkovatele přizpůsobení, nebo na vlastního zprostředkovatele uvedeného ve značkách WebPartManager stránky nebo ve ProviderName vlastnosti.
Zprostředkovatel je volána k určení možností uživatele (DetermineUserCapabilities) pro aktuálně spuštěného uživatele.
Stav přizpůsobení pro aktuální kombinaci stránky, uživatele a oboru je načten z podkladového úložiště dat poskytovatelem (LoadPersonalizationState) a uložen v instanci WebPartPersonalization .
Rozsah přizpůsobení aktuální stránky, uživatele nebo oboru je určen poskytovatelem (DetermineInitialScope). Všimněte si, že výsledek tohoto určení se může lišit od hodnoty InitialScope vlastnosti.
Hodnota oboru vrácená touto metodou se použije jako hodnota vlastnosti Scope .
Poznámka
K InvalidOperationException výjimce z důvodu nepovolení přizpůsobení dojde pouze v případě, že Load je metoda volána přímo. V implementaci ASP.NET je interní pomocná metoda ve skutečnosti volána k provedení zatížení a tato pomocná metoda bezobslužně vrátí, pokud pro stránku nebylo povoleno přizpůsobení.