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 Zustandsinformationen.
- value
- PersonalizationEntry
Zustandsinformationen, die dem Personalisierungswörterbuch hinzugefügt werden sollen. Dieser Wert kann null sein.
Ausnahmen
key ist bereits ein Duplikat eines Schlüssels im Wörterbuch.
- oder -
key ist eine leere Zeichenfolge (""). Das Verkürzen von key führt zu einer leeren Zeichenfolge.
- oder -
value ist keine PersonalizationEntry.
Hinweise
Sie können diese Methode aufrufen, verschiedene Teile benutzerdefinierter Zustandsinformationen im Zustandsobjekt platzieren und den dem Zustandswert zugeordneten Bereich angeben. Wenn sich ein WebPartManager Steuerelement im Shared Bereich befindet, können Sie Namens- und Zustandsinformationen hinzufügen, die entweder Shared dem Bereich oder User dem Bereich zugeordnet sind. Im User Bereich können Sie Namen und Zustandsinformationen hinzufügen, die nur dem User Bereich zugeordnet sind.
Es empfiehlt sich jedoch, dem Wörterbuch alle Eigenschaften mithilfe von Save Eigenschaften mit User oder Shared Bereich hinzuzufügen, unabhängig vom Bereich der Seite.
.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 im User Bereich ein WebPart Steuerelement 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 benutzerbezogenen Eigenschaften) gespeichert. Ausführliche Informationen zu Personalisierungsdaten und dazu, wie freigegebene und benutzerbezogene Eigenschaften vom Personalisierungsbereich der Seite beeinflusst werden, finden Sie im Thema Übersicht über die Webparts-Personalisierung .
Wie bei jeder Auflistung erhöht diese Methode die Auflistungsanzahl um eins, und alle derzeit für die Auflistung aktiven Enumeratoren sollten ungültig werden.
