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
Příklad PersonalizationScope nadřazeného objektu WebPartManager.
Výjimky
Tato metoda se volá, pokud není povolena přizpůsobení (Enabled rovná falsese).
nebo
Hodnota vlastnosti přidružené WebPartManagernullje Page .
nebo
Hodnota Request vlastnosti WebPartManager přidružené Page instance ovládacího prvku je null.
Zprostředkovatel byl explicitně nastaven v kódu stránky nebo 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 potížím.
nebo
V definici zprostředkovatele přizpůsobení v konfiguračním souboru došlo k chybě.
Základní zprostředkovatelé 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 osobních údajů jménem nadřazeného WebPartManager ovládacího prvku. Tato metoda se volá 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ána přizpůsobení, tato metoda nebude nikdy volána.
V průběhu této metody dochází k následujícím inicializacím:
Odkaz na výchozího zprostředkovatele přizpůsobení nebo vlastního zprostředkovatele uvedeného v WebPartManager kódu stránky nebo ProviderName vlastnosti se získá.
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/oboru je načten z podkladového úložiště dat poskytovatelem (LoadPersonalizationState) a uložen v instanci WebPartPersonalization .
Obor 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žívá jako hodnota vlastnosti Scope .
Poznámka:
K InvalidOperationException výjimce z důvodu nepovolování přizpůsobení dojde pouze v případě, Load že metoda je volána přímo. V ASP.NET implementaci je interní pomocná metoda ve skutečnosti volána k provedení načtení, a tato pomocná metoda bezobslužně vrátí, pokud pro stránku nebyla povolena přizpůsobení.