PersonalizationDictionary.Add(String, PersonalizationEntry) 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.
Fügt dem Personalisierungswörterbuch Personalisierungseinträge hinzu.
public:
virtual void Add(System::String ^ key, System::Web::UI::WebControls::WebParts::PersonalizationEntry ^ value);public virtual void Add(string key, System.Web.UI.WebControls.WebParts.PersonalizationEntry value);abstract member Add : string * System.Web.UI.WebControls.WebParts.PersonalizationEntry -> unit
override this.Add : string * System.Web.UI.WebControls.WebParts.PersonalizationEntry -> unitPublic Overridable Sub Add (key As String, value As PersonalizationEntry)Parameter
- key
- String
Der eindeutige Bezeichner für einen Teil der Statusinformationen.
- value
- PersonalizationEntry
Ein Teil der Statusinformationen, die dem Personalisierungswörterbuch hinzugefügt werden sollen. Dieser Wert kann null sein.
Ausnahmen
key ist ein Duplikat eines Schlüssels, der bereits im Wörterbuch enthalten ist.
-oder-
key ist entweder eine leere Zeichenfolge ("") oder das Kürzen key führt zu einer leeren Zeichenfolge.
-oder-
value ist kein PersonalizationEntry.
Hinweise
Sie können diese Methode aufrufen, verschiedene Teile von benutzerdefinierten Zustandsinformationen in das Statusobjekt einfügen und den Bereich angeben, der dem Statuswert zugeordnet ist. Wenn sich ein WebPartManager Steuerelement im Shared Bereich befindet, können Sie Namen- und Statusinformationen hinzufügen, die entweder Shared dem Bereich oder User dem Bereich zugeordnet sind. Im User Bereich können Sie Namen- und Statusinformationen hinzufügen, die nur dem User Bereich zugeordnet sind.
Es empfiehlt sich jedoch, alle Eigenschaften mithilfe von Save Eigenschaften oder UserShared Bereich zum Wörterbuch hinzuzufügen, unabhängig vom Seitenbereich.
Das .NET Framework speichert die Eigenschaften nur bei Bedarf mit Shared Bereich. Mit anderen Worten, freigegebene Eigenschaften werden nicht gespeichert, wenn ein WebPart Steuerelement, das ursprünglich im Shared Bereich hinzugefügt wurde, später gespeichert wird, während sich die Seite im User Bereich befindet. Wenn der Seite ein WebPart Steuerelement im User Bereich hinzugefügt wurde und das Steuerelement später gespeichert wird, während sich die Seite im Shared Bereich befindet, werden benutzerdefinierte freigegebene Eigenschaftswerte (zusammen mit benutzerdefinierten Benutzerdefinierten Eigenschafteneigenschaften) in einem entgegengesetzten Szenario gespeichert. Ausführliche Informationen zu Personalisierungsdaten und dazu, wie freigegebene und benutzerdefinierte Eigenschaften vom Personalisierungsbereich der Seite beeinflusst werden, finden Sie im Thema " Webparts Personalization Overview ".
Wie bei jeder Auflistung erhöht diese Methode die Auflistungsanzahl um einen, und alle Enumeratoren, die derzeit für die Auflistung aktiv sind, sollten ungültig sein.
