PersonalizationDictionary.Add(String, PersonalizationEntry) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee voegt u persoonlijke instellingen toe aan de persoonlijke woordenlijst.
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)Parameters
- key
- String
De unieke id voor een stukje statusinformatie.
- value
- PersonalizationEntry
Een stukje statusinformatie dat moet worden toegevoegd aan de persoonlijke woordenlijst. Deze waarde kan zijn null.
Uitzonderingen
key is een duplicaat van een sleutel die al in de woordenlijst staat.
– of –
key is een lege tekenreeks ("") of bijsnijden key resulteert in een lege tekenreeks.
– of –
value is geen PersonalizationEntry.
Opmerkingen
U kunt deze methode aanroepen, verschillende stukjes aangepaste statusgegevens in het statusobject plaatsen en het bereik opgeven dat is gekoppeld aan de statuswaarde. Wanneer een besturingselement binnen WebPartManager het Shared bereik valt, kunt u naam- en statusgegevens toevoegen die zijn gekoppeld aan Shared een bereik of User bereik. In User het bereik kunt u alleen naam- en statusinformatie toevoegen die is gekoppeld aan User het bereik.
Het is echter een goede gewoonte om alle eigenschappen toe te voegen aan de woordenlijst met behulp van Save eigenschappen met User of Shared bereik, ongeacht het bereik van de pagina.
Het .NET Framework slaat de eigenschappen alleen op met Shared bereik, indien van toepassing. Met andere woorden, gedeelde eigenschappen worden niet opgeslagen wanneer een WebPart besturingselement dat oorspronkelijk is toegevoegd aan Shared het bereik later wordt opgeslagen terwijl de pagina binnen User het bereik valt. In een tegenovergestelde scenario, als een WebPart besturingselement is toegevoegd aan de pagina in User het bereik en het besturingselement later wordt opgeslagen terwijl de pagina binnen Shared het bereik valt, worden aangepaste gedeelde eigenschapswaarden opgeslagen (samen met aangepaste eigenschappen van gebruikersbereik). Zie het onderwerp Overzicht van persoonlijke instellingen voor webonderdelen voor meer informatie over persoonlijke instellingen en hoe gedeelde en door de gebruiker gerichte eigenschappen worden beïnvloed door het persoonlijke bereik van de pagina.
Net als bij elke verzameling wordt met deze methode het aantal verzamelingen verhoogd met één en alle opsommingen die momenteel in de verzameling actief zijn, moet deze ongeldig worden gemaakt.
