WebPartPersonalization.Load Metod

Definition

Initierar anpassning.

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

Returer

En PersonalizationScope instans för den överordnade WebPartManager.

Undantag

Den här metoden anropas när anpassning inte är aktiverad (Enabled är lika med false).

-eller-

Värdet för Page egenskapen för den associerade WebPartManager är null.

-eller-

Värdet för Request egenskapen på kontrollens WebPartManager associerade Page instans är null.

En provider angavs uttryckligen i antingen sidmarkeringen ProviderName eller egenskapen och det gick inte att hitta providern.

-eller-

Objektet som innehåller personanpassningstillståndsdata är null.

Ett problem uppstod vid inläsning och deserialisering av data.

-eller-

Ett fel uppstod i definitionen av en personanpassningsprovider i konfigurationsfilen.

Det gick inte att initiera de underliggande personanpassningsleverantörerna eftersom det inte gick att hitta någon standardprovider eller på grund av ett fel när en personanpassningsprovider skulle initieras.

Kommentarer

Det här är den viktigaste startpunkten för att initiera personaliseringsinformation för den överordnade WebPartManager kontrollens räkning. Den här metoden anropas under den överordnade WebPartManager kontrollens OnInit metod. Om anpassningen har inaktiverats på den överordnade WebPartManager kontrollen anropas normalt aldrig den här metoden.

Under den här metoden sker följande initieringar:

  • En referens till antingen standardprovidern för anpassning eller den anpassade provider som anges i sidmarkeringen WebPartManagerProviderName eller egenskapen hämtas.

  • Providern anropas för att fastställa användarfunktionerna (DetermineUserCapabilities) för den användare som körs för närvarande.

  • Anpassningstillståndet för den aktuella kombinationen sida/användare/omfång läses in från det underliggande datalagret av providern (LoadPersonalizationState) och lagras i instansen WebPartPersonalization .

  • Anpassningsomfånget för den aktuella sidan/användaren/omfånget bestäms av providern (DetermineInitialScope). Observera att resultatet av den här bestämningen kan skilja sig från värdet för InitialScope egenskapen.

Omfångsvärdet som returneras från den här metoden används som värde för Scope egenskapen.

Note

Ett InvalidOperationException undantag på grund av att anpassning inte är aktiverat sker endast om Load metoden anropas direkt. I den ASP.NET implementeringen anropas faktiskt en intern hjälpmetod för att utföra belastningen, och den här hjälpmetoden returnerar tyst om anpassning inte har aktiverats för sidan.

Gäller för

Se även