PersonalizationDictionary.Add(String, PersonalizationEntry) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Ajoute des entrées de personnalisation au dictionnaire de personnalisation.
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)Paramètres
- key
- String
Identificateur unique pour une information d'état.
- value
- PersonalizationEntry
Information d'état à ajouter au dictionnaire de personnalisation. Cette valeur peut être null.
Exceptions
key est un doublon d'une clé figurant déjà dans le dictionnaire.
- ou -
key est une chaîne vide (""), ou la troncation des résultats key en une chaîne vide.
- ou -
value n’est pas un PersonalizationEntry.
Remarques
Vous pouvez appeler cette méthode, placer différentes informations d’état personnalisées dans l’objet d’état et spécifier l’étendue associée à la valeur d’état. Lorsqu’un WebPartManager contrôle est dans l’étendue Shared , vous pouvez ajouter des informations de nom et d’état associées à l’étendue ou à Shared l’étendue User . Dans User l’étendue, vous pouvez ajouter des informations de nom et d’état associées uniquement à l’étendue User .
Toutefois, il est recommandé d’ajouter toutes les propriétés au dictionnaire à l’aide Save des propriétés avec User ou Shared de l’étendue, quelle que soit l’étendue de la page.
Le .NET Framework enregistre uniquement les propriétés avec Shared étendue le cas échéant. En d’autres termes, les propriétés partagées ne sont pas enregistrées lorsqu’un WebPart contrôle initialement ajouté dans Shared l’étendue est enregistré ultérieurement pendant que la page est dans l’étendue User . Dans un scénario inverse, si un WebPart contrôle a été ajouté à la page dans User l’étendue et que le contrôle est enregistré ultérieurement pendant que la page est dans Shared l’étendue, les valeurs de propriétés partagées personnalisées sont enregistrées (ainsi que les propriétés personnalisées étendues à l’utilisateur). Pour plus d’informations sur les données de personnalisation et sur la façon dont les propriétés partagées et étendues à l’utilisateur sont affectées par l’étendue de personnalisation de la page, consultez la rubrique Vue d’ensemble de la personnalisation des composants WebPart .
Comme pour toute collection, cette méthode incrémente le nombre de collections d’un et tous les énumérateurs actuellement actifs sur la collection doivent être invalidés.
