PersonalizationDictionary.Add(String, PersonalizationEntry) Metoda

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls.WebParts

Zestaw:

System.Web.dll

Dodaje wpisy personalizacji do słownika personalizacji.

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

Unikatowy identyfikator informacji o stanie.

value

PersonalizationEntry

Element informacji o stanie, który ma zostać dodany do słownika personalizacji. Ta wartość może być następująca null: .

Wyjątki

ArgumentException

key jest duplikatem klucza już w słowniku.

-lub-

key jest pustym ciągiem ("") lub przycinaniem key powoduje utworzenie pustego ciągu.

-lub-

value nie jest elementem PersonalizationEntry.

ArgumentNullException

key to null.

-lub-

value to null.

Uwagi

Możesz wywołać tę metodę, umieścić różne elementy informacji o stanie niestandardowym w obiekcie stanu i określić zakres skojarzony z wartością stanu. Gdy kontrolka WebPartManager znajduje się w Shared zakresie, możesz dodać informacje o nazwie i stanie skojarzone z zakresem lub User zakresemShared. W User zakresie można dodawać informacje o nazwie i stanie skojarzone tylko z zakresem User .

Dobrym rozwiązaniem jest jednak dodanie wszystkich właściwości do słownika przy użyciu Save właściwości z zakresem lub Shared właściwościami User niezależnie od zakresu strony.

Program .NET Framework zapisuje tylko właściwości z zakresem Shared , jeśli jest to konieczne. Innymi słowy, właściwości udostępnione nie są zapisywane, gdy WebPart kontrolka, która została początkowo dodana w Shared zakresie, zostanie później zapisana, gdy strona jest w User zakresie. W przeciwnym scenariuszu, jeśli kontrolka WebPart została dodana do strony w User zakresie, a kontrolka zostanie później zapisana, gdy strona jest w Shared zakresie, niestandardowe wartości właściwości udostępnione są zapisywane (wraz z niestandardowymi właściwościami o zakresie użytkownika). Aby uzyskać szczegółowe informacje na temat danych personalizacji oraz sposobu, w jaki mają wpływ właściwości udostępnione i właściwości o zakresie personalizacji strony, zobacz temat Omówienie personalizacji składników Web Part .

Podobnie jak w przypadku dowolnej kolekcji, ta metoda zwiększa liczbę kolekcji o jedną, a wszystkie moduły wyliczania aktualnie aktywne w kolekcji powinny zostać unieważnione.

Zobacz też

• Omówienie personalizacji składników Web Part