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 być następująca null: .
Wyjątki
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.
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.
