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 das übergeordnete Element WebPartManager.
Ausnahmen
Diese Methode wird aufgerufen, wenn die Personalisierung nicht aktiviert ist (Enabled entspricht false).
- oder -
Der Wert der Page Eigenschaft für die zugeordnete WebPartManager Eigenschaft ist null.
- oder -
Der Wert der Request Eigenschaft für die WebPartManager zugeordnete Page Instanz des Steuerelements lautet null.
Ein Anbieter wurde explizit im Seitenmarkup oder in der ProviderName Eigenschaft festgelegt, und der Anbieter konnte nicht gefunden werden.
- oder -
Das Objekt, das die Personalisierungsstatusdaten enthält, ist null.
Beim Laden und Deserialisieren von Daten ist ein Problem aufgetreten.
- oder -
Fehler in der Definition eines Personalisierungsanbieters in der Konfigurationsdatei.
Die zugrunde liegenden Personalisierungsanbieter konnten nicht initialisiert werden, da ein Standardanbieter nicht gefunden wurde oder weil beim Versuch, einen Personalisierungsanbieter zu initialisieren, ein Fehler aufgetreten ist.
Hinweise
Dies ist der Haupteinstiegspunkt 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 normalerweise 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 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 von dem Wert der InitialScope Eigenschaft unterscheidet.
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 im Hintergrund zurück, wenn die Personalisierung für die Seite nicht aktiviert wurde.
