PersonalizationProvider.LoadPersonalizationState Methode

Definitie

Laadt de onbewerkte gegevens uit het onderliggende gegevensarchief en converteert die gegevens naar een PersonalizationState object.

public:
 virtual System::Web::UI::WebControls::WebParts::PersonalizationState ^ LoadPersonalizationState(System::Web::UI::WebControls::WebParts::WebPartManager ^ webPartManager, bool ignoreCurrentUser);
public virtual System.Web.UI.WebControls.WebParts.PersonalizationState LoadPersonalizationState(System.Web.UI.WebControls.WebParts.WebPartManager webPartManager, bool ignoreCurrentUser);
abstract member LoadPersonalizationState : System.Web.UI.WebControls.WebParts.WebPartManager * bool -> System.Web.UI.WebControls.WebParts.PersonalizationState
override this.LoadPersonalizationState : System.Web.UI.WebControls.WebParts.WebPartManager * bool -> System.Web.UI.WebControls.WebParts.PersonalizationState
Public Overridable Function LoadPersonalizationState (webPartManager As WebPartManager, ignoreCurrentUser As Boolean) As PersonalizationState

Parameters

webPartManager
WebPartManager

Het WebPartManager beheren van de persoonlijke gegevens.

ignoreCurrentUser
Boolean

Een Boolean die aangeeft of de gebruikersnaam moet worden doorgegeven aan de personalisatieprovider.

Retouren

Een PersonalizationState met persoonlijke gegevens.

Uitzonderingen

De webPartManager is null.

De pagina die is gekoppeld aan webPartManager is null.

– of –

De aanvraag die aan de pagina is gekoppeld, is null.

Opmerkingen

Deze methode is het belangrijkste toegangspunt dat door de WebPartPersonalization klasse wordt gebruikt om persoonlijke gegevens te laden. De standaard implementatie laadt de onbewerkte gegevens uit het onderliggende gegevensarchief (functionaliteit wordt geïmplementeerd in afgeleide providers) en converteert vervolgens de onbewerkte gegevens naar een PersonalizationState exemplaar.

Als de ignoreCurrentUser parameter is true, wordt er geen gebruikersnaam doorgegeven aan de LoadPersonalizationBlobs methode. Een personalisatieprovider kan ervoor kiezen om dit te interpreteren als betekenis dat alleen de persoonlijke status met een Shared bereik moet worden opgehaald uit het onderliggende gegevensarchief.

Wanneer de Load methode wordt uitgevoerd, wordt de LoadPersonalizationState methode aangeroepen en zijn er drie typen deserialisatiefouten die kunnen optreden wanneer de status wordt geladen. Wanneer deze specifieke fouten optreden, wordt er geen uitzondering gegenereerd en worden de foutgebeurtenissen in plaats daarvan vastgelegd door de functie Statuscontrole (zie ASP.NET Overzicht van statuscontrole) voor informatie over statuscontrole en het openen van de logboeken die hiermee zijn gemaakt. De volgende drie scenario's veroorzaken deserialisatiefout gebeurtenissen die naar het logboek worden geschreven:

  • Een mislukte poging om een eigenschapstype te deserialiseren dat gebruikmaakt van een tekenreeks TypeConverter.

  • Een mislukte poging om een eigenschapstype te deserialiseren dat gebruikmaakt van binaire serialisatie.

  • Een mislukte poging om een eigenschapstype te deserialiseren omdat er geen exemplaar van het type kan worden gemaakt.

Van toepassing op