IVersioningPersonalizable.Load(IDictionary) 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.
Lädt Personalisierungsdaten in ein Webpart-Steuerelement, das aufgrund einer Versionsänderung keine entsprechende personalisierte Eigenschaft für die Daten aufweist.
public:
void Load(System::Collections::IDictionary ^ unknownProperties);public void Load(System.Collections.IDictionary unknownProperties);abstract member Load : System.Collections.IDictionary -> unitPublic 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 sowohl des Bereichs "Benutzer" als auch des Bereichs "Freigegeben", die nicht auf das Steuerelement angewendet werden konnten. Wenn eine Seite im Benutzerbereich ausgeführt wird, werden die unbekannten Benutzerbereichswerte (sofern verfügbar) anstelle unbekannter Werte für freigegebene Bereiche angegeben. Diese Informationen werden als Eine Reihe von Namens-Wert-Paaren gespeichert, wobei jeder Name der Zeichenfolgenname einer Eigenschaft ist, die für das Steuerelement nicht gefunden wurde, und jeder Wert enthält den Eigenschaftswert. Es liegt in der Verantwortung des Steuerelements, den Wert in den entsprechenden Typ umzuwandeln oder zu konvertieren und eine weitere Verarbeitung durchzuführen (z. B. Zuordnungsdaten aus einer alten Eigenschaft zu einer neuen Eigenschaft).
Wenn sich der Status eines Steuerelements ändert, sollte es aufgerufen SetPersonalizationDirty werden (entweder die geerbte Methode oder die öffentliche statische Methode im Fall eines Steuerelements, das nicht von WebPart). Wenn sich ein Steuerelement als "schmutzig" markiert, extrahiert der Steuerelementsatz webparts Personalisierungsdaten aus dem Steuerelement, unabhängig vom Zustand "schmutzig" 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 geändert hat, da die Werte im unknownProperties Parameter verarbeitet werden.
Beachten Sie, dass diese Methode automatisch aufgerufen wird, wenn verwaiste Eigenschaften beim Importieren von Webpart-Steuerelementen erkannt werden.
