WebPartPersonalization.Load Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Initialiseert persoonlijke instellingen.
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.PersonalizationScopeProtected Overridable Function Load () As PersonalizationScopeRetouren
Een PersonalizationScope exemplaar voor het bovenliggende WebPartManageritem.
Uitzonderingen
Deze methode wordt aangeroepen wanneer persoonlijke instellingen niet zijn ingeschakeld (Enabledis gelijk aan).false
– of –
De waarde van de Page eigenschap voor de gekoppelde WebPartManager is null.
– of –
De waarde van de Request eigenschap op het WebPartManager bijbehorende besturingselementexemplaar Page is null.
Een provider is expliciet ingesteld in de paginamarkeringen of de ProviderName eigenschap en de provider is niet gevonden.
– of –
Het object met de persoonlijke statusgegevens is null.
Er is een probleem opgetreden bij het laden en deserialisatie van gegevens.
– of –
Er is een fout opgetreden in de definitie van een personalisatieprovider in het configuratiebestand.
De onderliggende personalisatieproviders kunnen niet worden geïnitialiseerd omdat er geen standaardprovider is gevonden of omdat er een fout is opgetreden tijdens het initialiseren van een persoonlijke provider.
Opmerkingen
Dit is het belangrijkste toegangspunt voor het initialiseren van persoonlijke gegevens namens het bovenliggende WebPartManager besturingselement. Deze methode wordt aangeroepen tijdens de methode van WebPartManager het bovenliggende OnInit besturingselement. Normaal gesproken wordt deze methode nooit aangeroepen als persoonlijke instellingen zijn uitgeschakeld voor het bovenliggende WebPartManager besturingselement.
Tijdens de loop van deze methode vinden de volgende initialisaties plaats:
Een verwijzing naar de standaardprovider voor persoonlijke instellingen, of de aangepaste provider die wordt aangegeven in de WebPartManager paginamarkeringen of de ProviderName eigenschap, wordt verkregen.
De provider wordt aangeroepen om de gebruikersmogelijkheden (DetermineUserCapabilities) te bepalen voor de gebruiker die momenteel wordt uitgevoerd.
De persoonlijke status voor de huidige combinatie van pagina/gebruiker/bereik wordt geladen vanuit het onderliggende gegevensarchief door de provider (LoadPersonalizationState) en opgeslagen in het WebPartPersonalization exemplaar.
Het persoonlijke bereik voor de huidige pagina/gebruiker/bereik wordt bepaald door de provider (DetermineInitialScope). Houd er rekening mee dat het resultaat van deze bepaling mogelijk anders is dan de waarde van de InitialScope eigenschap.
De bereikwaarde die door deze methode wordt geretourneerd, wordt gebruikt als de waarde voor de Scope eigenschap.
Note
Een InvalidOperationException uitzondering omdat persoonlijke instellingen niet zijn ingeschakeld, vindt alleen plaats als de Load methode rechtstreeks wordt aangeroepen. In de ASP.NET-implementatie wordt een interne helpermethode aangeroepen om de belasting uit te voeren. Deze helpermethode retourneert op de achtergrond als persoonlijke instellingen niet zijn ingeschakeld voor de pagina.
