IVersioningPersonalizable.Load(IDictionary) Methode

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Lädt Personalisierungsdaten auf ein Webpartssteuerelement, das aufgrund einer Versionsänderung nicht über eine entsprechende personalisierte Eigenschaft für die Daten verfügt.

public:
 void Load(System::Collections::IDictionary ^ unknownProperties);

public void Load (System.Collections.IDictionary unknownProperties);

abstract member Load : System.Collections.IDictionary -> unit

Public Sub Load (unknownProperties As IDictionary)

Parameter

unknownProperties

IDictionary

Ein Wörterbuch mit Personalisierungsdaten, die nicht auf ein Steuerelement angewendet werden konnten.

Hinweise

Der unknownProperties Parameter enthält eine zusammengeführte Darstellung unbekannter Personalisierungsdaten des Bereichs "Benutzer" und "Freigegeben", die nicht auf das Steuerelement angewendet werden konnten. Wenn eine Seite im Benutzerbereich ausgeführt wird, werden die unbekannten Benutzerbereichswerte (sofern verfügbar) und nicht unbekannte Werte für freigegebenen Bereich angegeben. Diese Informationen werden als eine Reihe von Namen-Wert-Paaren gespeichert, wobei jeder Name der Zeichenfolgenname einer Eigenschaft ist, die im Steuerelement nicht gefunden wurde, und jeder Wert den Eigenschaftswert enthält. Es liegt in der Verantwortung des Steuerelements, den Wert in den entsprechenden Typ umzuwandeln oder zu konvertieren und die weitere Verarbeitung durchzuführen (z. B. das Zuordnen von Daten aus einer alten Eigenschaft zu einer neuen Eigenschaft).

Wenn sich der Zustand eines Steuerelements ändert, sollte es (entweder die geerbte Methode oder die öffentliche statische Methode im Fall eines Steuerelements, das nicht von WebPartabgeleitet wird) aufrufen SetPersonalizationDirty . Wenn sich ein Steuerelement als "schmutzig" markiert, extrahiert der Webparts-Steuerelementsatz Personalisierungsdaten aus dem Steuerelement, unabhängig vom "schmutzigen" Zustand des Steuerelements, und speichert es später im Personalisierungslebenszyklus wieder im zugrunde liegenden Datenspeicher. Ein Steuerelement sollte sich selbst als "schmutzig" markieren, wenn sich der Zustand des Steuerelements infolge der Verarbeitung der Werte im unknownProperties Parameter geändert hat.

Beachten Sie, dass diese Methode automatisch aufgerufen wird, wenn verwaiste Eigenschaften beim Importieren von Webpart-Steuerelementen erkannt werden.