PersonalizationProvider.LoadPersonalizationState Methode

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Lädt die Rohdaten aus dem zugrunde liegenden Datenspeicher und konvertiert diese Daten in ein PersonalizationState Objekt.

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

Parameter

webPartManager
WebPartManager

Die WebPartManager Verwaltung der Personalisierungsdaten.

ignoreCurrentUser
Boolean

Ein Boolean Hinweis darauf, ob der Benutzername an den Personalisierungsanbieter übergeben werden soll.

Gibt zurück

PersonalizationState

Eine PersonalizationState enthaltende Personalisierungsdaten.

Ausnahmen

ArgumentNullException

webPartManager ist null.

ArgumentException

Die zugeordnete webPartManager Seite ist null.

-oder-

Die mit der Seite verknüpfte Anforderung ist null.

Hinweise

Diese Methode ist der Haupteinstiegspunkt, der von der WebPartPersonalization Klasse zum Laden von Personalisierungsdaten verwendet wird. Die Standardimplementierung lädt die Rohdaten aus dem zugrunde liegenden Datenspeicher (Funktionalität wird in abgeleiteten Anbietern implementiert) und konvertiert dann die Rohdaten in eine PersonalizationState Instanz.

Wenn der ignoreCurrentUser Parameter lautet true, wird kein Benutzername an die LoadPersonalizationBlobs Methode übergeben. Ein Personalisierungsanbieter kann dies so interpretieren, dass nur der Personalisierungszustand mit einem Shared Bereich aus dem zugrunde liegenden Datenspeicher abgerufen werden soll.

Wenn die Load Methode ausgeführt wird, ruft sie die LoadPersonalizationState Methode auf, und es gibt drei Arten von Deserialisierungsfehlern, die auftreten können, wenn der Zustand geladen wird. Wenn diese spezifischen Fehler auftreten, wird keine Ausnahme ausgelöst, und die Fehlerereignisse werden stattdessen vom Feature "Integritätsüberwachung" protokolliert (Informationen zur Integritätsüberwachung und zum Zugreifen auf die darin erstellten Protokolle finden Sie unter ASP.NET Health Monitoring Overview). Die folgenden drei Szenarien führen dazu, dass Deserialisierungsfehlerereignisse in das Protokoll geschrieben werden:

  • Fehler beim Versuch, einen Eigenschaftstyp zu deserialisieren, der eine Zeichenfolge TypeConverterverwendet.

  • Fehler beim Versuch, einen Eigenschaftstyp zu deserialisieren, der binäre Serialisierung verwendet.

  • Fehler beim Versuch, einen Eigenschaftstyp deserialisieren, da eine Instanz des Typs nicht erstellt werden kann.

Gilt für: