PersonalizationDictionary.Add(String, PersonalizationEntry) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Lägger till anpassningsposter i anpassningsordlistan.
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)Parametrar
- key
- String
Den unika identifieraren för en del av tillståndsinformationen.
- value
- PersonalizationEntry
En del tillståndsinformation som ska läggas till i anpassningsordlistan. Det här värdet kan vara null.
Undantag
key är en dubblett av en nyckel som redan finns i ordlistan.
-eller-
key är antingen en tom sträng ("") eller trimning key resulterar i en tom sträng.
-eller-
value är inte en PersonalizationEntry.
Kommentarer
Du kan anropa den här metoden, placera olika delar av anpassad tillståndsinformation i tillståndsobjektet och ange det omfång som är associerat med tillståndsvärdet. När en WebPartManager kontroll finns i Shared omfånget kan du lägga till namn- och tillståndsinformation som är associerad med omfång Shared eller User omfång. I User omfånget kan du lägga till namn- och tillståndsinformation som endast är associerad med User omfånget.
Det är dock bra att lägga till alla egenskaper i ordlistan med hjälp av Save inklusive egenskaper med User eller Shared omfång, oavsett omfånget på sidan.
.NET Framework sparar bara egenskaperna med Shared omfång när det är lämpligt. Med andra ord sparas inte delade egenskaper när en WebPart kontroll som ursprungligen lades till i Shared omfånget senare sparas medan sidan finns i User omfånget. I ett motsatt scenario, om en WebPart kontroll lades till på sidan i User omfånget och kontrollen sparas senare medan sidan är i Shared omfånget, sparas anpassade delade egenskapsvärden (tillsammans med anpassade egenskaper för användaromfång). Mer information om anpassningsdata och hur delade och användaromfattande egenskaper påverkas av sidans anpassningsomfång finns i avsnittet Översikt över anpassning av webbdelar .
Precis som med alla samlingar ökar den här metoden samlingsantalet med en och alla uppräknare som för närvarande är aktiva i samlingen bör ogiltigförklaras.
