PersonalizationDictionary.Add(String, PersonalizationEntry) Metoda

Definice

Obor názvů:

System.Web.UI.WebControls.WebParts

Sestavení:

System.Web.dll

Přidá položky přizpůsobení do slovníku přizpůsobení.

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)

Parametry

key

String

Jedinečný identifikátor informace o stavu.

value

PersonalizationEntry

Informace o stavu, které mají být přidány do slovníku přizpůsobení. Tato hodnota může být null.

Výjimky

ArgumentException

key je duplikát klíče, který už je ve slovníku.

-nebo-

key je buď prázdný řetězec (""), nebo výsledkem oříznutí key bude prázdný řetězec.

-nebo-

valuenení .PersonalizationEntry

ArgumentNullException

key je null.

-nebo-

value je null.

Poznámky

Můžete volat tuto metodu, umístit různé části vlastní informace o stavu do objektu stavu a zadat obor přidružený k hodnotě stavu. WebPartManager Pokud je ovládací prvek v Shared oboru, můžete přidat informace o názvu a stavu, které jsou přidružené k Shared oboru nebo User oboru. Do User oboru můžete přidat informace o názvu a stavu přidružené pouze k User oboru.

Je však vhodné přidat všechny vlastnosti do slovníku pomocí Save zahrnutí vlastností s oborem User nebo Shared bez ohledu na rozsah stránky.

Rozhraní .NET Framework ukládá vlastnosti s oborem Shared pouze v případě potřeby. Jinými slovy, sdílené vlastnosti se neuloží, když WebPart se ovládací prvek, který byl původně přidán do Shared oboru, uloží později, když je stránka v User oboru. V opačné situaci platí, že pokud WebPart byl na stránku v User oboru přidán ovládací prvek a tento ovládací prvek se později uloží, zatímco je stránka v Shared oboru, vlastní hodnoty sdílených vlastností se uloží (společně s vlastními vlastnostmi v oboru uživatele). Podrobnosti o datech přizpůsobení a o tom, jak jsou rozsahem přizpůsobení stránky ovlivněny sdílené vlastnosti a vlastnosti v rozsahu uživatele, najdete v tématu Přehled přizpůsobení webových částí .

Stejně jako u jakékoli jiné kolekce tato metoda zvýší počet kolekcí o jednu a všechny enumerátory aktuálně aktivní v kolekci by měly být zneplatněny.

Viz také

• Přehled přizpůsobení webových částí