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 pour une information d'état.

value

PersonalizationEntry

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

Exceptions

ArgumentException

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.

ArgumentNullException

key a la valeur null.

-ou-

value a la valeur null.

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.

Voir aussi

• Vue d’ensemble de la personnalisation des composants WebPart