PersonalizationDictionary.Add(String, PersonalizationEntry) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 -> unitPublic 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 mieć wartość null.
Wyjątki
key jest duplikatem klucza już w słowniku.
— lub —
key jest pustym ciągiem ("") lub przycinaniem key powoduje pusty ciąg.
— lub —
valuenie jest .PersonalizationEntry
Uwagi
Można wywołać tę metodę, umieścić różne fragmenty niestandardowych informacji o stanie 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 Shared zakresemUser. 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 User właściwościami Shared niezależnie od zakresu strony.
Struktura .NET 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 kontrolka WebPart , 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 współużytkowanych są zapisywane (wraz z niestandardowymi właściwościami o zakresie użytkownika). Aby uzyskać szczegółowe informacje na temat danych personalizacji oraz wpływu właściwości udostępnionych i właściwości o zakresie użytkownika na zakres 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.
