PersonalizationDictionary.Add(String, PersonalizationEntry) Méthode

Définition

Espace de noms:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

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 -> unit
Public Overridable Sub Add (key As String, value As PersonalizationEntry)

Paramètres

key
String

Identificateur unique d’un élément d’état.

value
PersonalizationEntry

Informations d’état à ajouter au dictionnaire de personnalisation. Cette valeur peut être null.

Exceptions

ArgumentException

key est un doublon d’une clé déjà dans le dictionnaire.

- ou -

key est une chaîne vide («  ») ou une suppression key entraîne une chaîne vide.

- ou -

value n’est pas un PersonalizationEntry.

ArgumentNullException

key a la valeur null.

- ou -

value a la valeur null.

Remarques

Vous pouvez appeler cette méthode, placer différents éléments d’informations d’état personnalisés dans l’objet d’état et spécifier l’étendue associée à la valeur d’état. Lorsqu’un contrôle est dans WebPartManager l’étendueShared, vous pouvez ajouter des informations de nom et d’état associées à Shared l’étendue ou User à l’étendue. Dans User l’étendue, vous pouvez ajouter des informations de nom et d’état associées uniquement à User l’étendue.

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 framework .NET 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 User l’étendue. Dans un scénario opposé, 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é partagée personnalisées sont enregistrées (ainsi que les propriétés personnalisées délimitées par l’utilisateur). Pour plus d’informations sur les données de personnalisation et la façon dont les propriétés partagées et délimitées par 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 n’importe quelle collection, cette méthode incrémente le nombre de collections par un et tous les énumérateurs actuellement actifs sur la collection doivent être invalidés.

S’applique à

Voir aussi