PersonalizationProvider.LoadPersonalizationState Methode

Referenz

Definition

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

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Der WebPartManager, der die Personalisierungsdaten verwaltet.

ignoreCurrentUser: Boolean

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

Gibt zurück

PersonalizationState

Ein PersonalizationState, der Personalisierungsdaten enthält.

Ausnahmen

ArgumentNullException

webPartManager ist null.

ArgumentException

Die dem webPartManager zugeordnete Seite ist null.

- oder - Die der Seite zugeordnete Anforderung ist null.

Hinweise

Diese Methode ist der Haupteinstiegspunkt, der von der -Klasse zum WebPartPersonalization 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 die Rohdaten dann in eine PersonalizationState -Instanz.

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

Wenn die Methode ausgeführt wird, ruft sie die -Methode auf, und es gibt drei Arten von Load Deserialisierungsfehlern, die beim Laden des LoadPersonalizationState Zustands auftreten können. Wenn diese spezifischen Fehler auftreten, wird keine Ausnahme ausgelöst, und die Fehlerereignisse werden stattdessen vom Integritätsüberwachungsfeature protokolliert (Informationen zur Integritätsüberwachung und zum Zugriff auf die von ihr erstellten Protokolle finden Sie unter ASP.NET Health Monitoring Overview). In den folgenden drei Szenarien werden Deserialisierungsfehlerereignisse in das Protokoll geschrieben:

Fehler beim Deserialisieren eines Eigenschaftentyps, der eine Zeichenfolge TypeConverter verwendet.
Fehler beim Deserialisieren eines Eigenschaftentyps, der die binäre Serialisierung verwendet.
Fehler beim Deserialisieren eines Eigenschaftentyps, da keine Instanz des Typs erstellt werden kann.

Gilt für