Freigeben über

WebPartPersonalization.Load Methode

  • Referenz

Definition

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

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.PersonalizationScope
Protected Overridable Function Load () As PersonalizationScope

Gibt zurück

PersonalizationScope

Eine PersonalizationScope-Instanz für den übergeordneten WebPartManager.

Ausnahmen

InvalidOperationException

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.

ProviderException

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.

ArgumentException

Beim Laden und Deserialisieren von Daten ist ein Problem aufgetreten.

- oder -

Bei der Definition eines Personalisierungsanbieters in der Konfigurationsdatei ist ein Fehler aufgetreten.

ConfigurationErrorsException

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.

Gilt für:

Weitere Informationen