PersonalizationDictionary.Add(String, PersonalizationEntry) Metoda

  • Reference

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 informací 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ý již ve slovníku existuje.

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

-nebo- value není PersonalizationEntry .

ArgumentNullException

key je null.

-nebo- value je null.

Poznámky

Můžete zavolat tuto metodu, umístit různé části vlastního stavu do objektu State a zadat obor přidružený k hodnotě State. Když WebPartManager je ovládací prvek v Shared oboru, můžete přidat název a informace o stavu, které jsou přidruženy k Shared oboru nebo User oboru. V User oboru můžete přidat informace o jménech a stavu, které jsou přidruženy pouze k User oboru.

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

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

Stejně jako u libovolné kolekce Tato metoda zvýší počet kolekcí o jeden a všechny enumerátory, které jsou v kolekci aktuálně aktivní, by měly být neověřené.

Platí pro

Viz také