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 normalerweise für das übergeordnete WebPartManager Steuerelement deaktiviert wurde, wird diese Methode nie aufgerufen.
Im Verlauf dieser Methode treten die folgenden Initialisierungen auf:
Ein Verweis auf den Standardpersonalisierungsanbieter oder den benutzerdefinierten Anbieter, der WebPartManager im Seitenmarkup oder in der ProviderName Eigenschaft angegeben ist, wird abgerufen.
Der Anbieter wird aufgerufen, um die Benutzerfunktionen (DetermineUserCapabilities) für den aktuell ausgeführten Benutzer zu ermitteln.
Der Personalisierungsstatus für die aktuelle Seite/Benutzer/Bereichskombination wird aus dem zugrunde liegenden Datenspeicher des Anbieters (LoadPersonalizationState) geladen und innerhalb der WebPartPersonalization Instanz gespeichert.
Der Personalisierungsbereich für die aktuelle Seite/den Benutzer/Bereich wird vom Anbieter (DetermineInitialScope) bestimmt. Beachten Sie, dass das Ergebnis dieser Bestimmung möglicherweise anders als der Wert der InitialScope Eigenschaft sein kann.
Der von dieser Methode zurückgegebene Bereichswert wird als Wert für die Scope Eigenschaft verwendet.
Hinweis
Eine InvalidOperationException Ausnahme aufgrund der nicht aktivierten Personalisierung tritt nur auf, wenn die Load Methode direkt aufgerufen wird. In der ASP.NET Implementierung wird tatsächlich eine interne Hilfsmethode aufgerufen, um die Last auszuführen, und diese Hilfsmethode gibt automatisch zurück, wenn die Personalisierung für die Seite nicht aktiviert wurde.