Freigeben über

PersonalizationDictionary.Add(String, PersonalizationEntry) Methode

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

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

ArgumentException

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.

ArgumentNullException

key ist null.

- oder -

value ist null.

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.

Gilt für:

Weitere Informationen