WebPartPersonalization.Load Methode
Definition
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.
Initialisiert die Personalisierung.
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 PersonalizationScopeGibt zurück
Eine PersonalizationScope-Instanz für den übergeordneten WebPartManager.
Ausnahmen
Diese Methode wird aufgerufen, wenn die Personalisierung nicht aktiviert ist (Enabled entspricht false).
- oder -
Der Wert der Page-Eigenschaft für den zugeordneten WebPartManager ist null.
- oder -
Der Wert der Request-Eigenschaft für die dem WebPartManager-Steuerelement zugeordnete Page-Instanz ist null.
Ein entweder im Markup der Seite oder mit der ProviderName-Eigenschaft explizit festgelegter Anbieter konnte nicht gefunden werden.
- oder -
Das Objekt, das die Personalisierungszustandsdaten enthält, ist null.
Beim Laden und Deserialisieren von Daten ist ein Problem aufgetreten.
- oder -
Bei der Definition eines Personalisierungsanbieters in der Konfigurationsdatei ist ein Fehler aufgetreten.
Die Initialisierung durch die zugrunde liegenden Personalisierungsanbieter ist fehlgeschlagen, da kein Standardanbieter gefunden werden konnte, oder weil beim Versuch der Initialisierung eines Personalisierungsanbieters ein Fehler aufgetreten ist.
Hinweise
Dies ist der wichtigste Einstiegspunkt für die Initialisierung von Personalisierungsinformationen im Namen des übergeordneten WebPartManager Steuerelements. Diese Methode wird während der -Methode des übergeordneten WebPartManager Steuerelements OnInit aufgerufen. Wenn die Personalisierung für das übergeordnete WebPartManager Steuerelement deaktiviert wurde, wird diese Methode in der Regel nie aufgerufen.
Im Verlauf dieser Methode treten die folgenden Initialisierungen auf:
Ein Verweis auf den Standardpersonalisierungsanbieter oder den benutzerdefinierten Anbieter, der im Seitenmarkup oder der WebPartManagerProviderName -Eigenschaft angegeben ist, wird abgerufen.
Der Anbieter wird aufgerufen, um die Benutzerfunktionen (DetermineUserCapabilities) für den derzeit ausführenden Benutzer zu bestimmen.
Der Personalisierungszustand für die aktuelle Kombination aus Seite/Benutzer/Bereich wird vom Anbieter (LoadPersonalizationState) aus dem zugrunde liegenden Datenspeicher geladen und in der WebPartPersonalization Instanz gespeichert.
Der Personalisierungsbereich für die aktuelle Seite/den aktuellen Benutzer/Bereich wird vom Anbieter (DetermineInitialScope) bestimmt. Beachten Sie, dass sich das Ergebnis dieser Bestimmung möglicherweise vom Wert der InitialScope -Eigenschaft unterscheiden kann.
Der von dieser Methode zurückgegebene Bereichswert wird als Wert für die Scope -Eigenschaft verwendet.
Hinweis
Eine InvalidOperationException Ausnahme, die darauf zurückzuführen ist, dass die Personalisierung nicht aktiviert wird, tritt nur auf, wenn die Load -Methode direkt aufgerufen wird. In der ASP.NET Implementierung wird tatsächlich eine interne Hilfsmethode aufgerufen, um das Laden auszuführen, und diese Hilfsmethode gibt automatisch zurück, wenn die Personalisierung für die Seite nicht aktiviert wurde.
