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 -> unit
Public 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 aufzurufen, verschiedene Teile von benutzerdefinierten Zustandsinformationen in das State-Objekt platzieren und den Bereich angeben, der dem Zustandswert zugeordnet ist. Wenn sich ein Steuerelement im Gültigkeits WebPartManager Shared Bereich befindet, können Sie Name-und Zustandsinformationen hinzufügen, die entweder dem Shared Bereich oder dem Bereich zugeordnet sind User . Im User Bereich können Sie Name-und Zustandsinformationen hinzufügen, die nur dem Bereich zugeordnet sind User .
Es empfiehlt sich jedoch, alle Eigenschaften zum Wörterbuch hinzuzufügen, indem Sie die Save Eigenschaften mit User oder dem Shared Bereich einschließen, unabhängig vom Bereich der Seite.
Der .NET Framework speichert die Eigenschaften nur mit Gültigkeits Shared Bereich, wenn dies angebracht ist. Anders ausgedrückt werden freigegebene Eigenschaften nicht gespeichert, wenn ein WebPart Steuerelement, das anfänglich dem Bereich hinzugefügt wurde, Shared später gespeichert wird, während sich die Seite im Gültigkeits User Bereich befindet. In einem umgekehrten Szenario, wenn ein WebPart Steuerelement der Seite im Gültigkeitsbereich hinzugefügt wurde User und das Steuerelement später gespeichert wird, während sich die Seite im Gültigkeits Shared Bereich befindet, werden benutzerdefinierte Eigenschaftswerte gespeichert (zusammen mit benutzerdefinierten Benutzer bezogenen Eigenschaften). Ausführliche Informationen zu Personalisierungs Daten und dazu, wie sich der Personalisierungs Bereich der Seite auf freigegebene und benutzerspezifische Eigenschaften auswirkt, finden Sie im Thema Webparts Personalisierungs Übersicht .
Wie bei jeder Auflistung erhöht diese Methode die Anzahl der Sammlungen um eins, und alle aktuell in der Auflistung aktiven Enumeratoren sollten für ungültig erklärt werden.