PersonalizationDictionary.Add(String, PersonalizationEntry) Méthode

Définition

Ajoute des entrées de personnalisation au dictionnaire de personnalisation.Adds personalization entries to the personalization dictionary.

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.The unique identifier for a piece of state information.

value
PersonalizationEntry

Information d'état à ajouter au dictionnaire de personnalisation.A piece of state information to be added to the personalization dictionary. Cette valeur peut être null.This value can be null.

Exceptions

key est un doublon d'une clé figurant déjà dans le dictionnaire.key is a duplicate of a key already in the dictionary.

- ou --or- key est une chaîne vide (""), ou la troncation des résultats key en une chaîne vide.key is either an empty string ("") or trimming key results in an empty string.

- ou --or- value n’est pas un PersonalizationEntry.value is not a PersonalizationEntry.

key est null.key is null.

- ou --or- value a la valeur null.value is null.

Remarques

Vous pouvez appeler cette méthode, placer différentes parties d’informations d’état personnalisées dans l’objet d’État et spécifier l’étendue associée à la valeur d’État.You can call this method, place various pieces of custom state information into the state object, and specify the scope associated with the state value. Quand un WebPartManager contrôle est dans Shared la portée, vous pouvez ajouter des informations de nom et d’état associées Shared à l' User étendue ou à l’étendue.When a WebPartManager control is in Shared scope, you can add name and state information that is associated with either Shared scope or User scope. Dans User étendue, vous pouvez ajouter des informations de nom et d’état User associées uniquement à l’étendue.In User scope, you can add name and state information associated only with User scope.

Toutefois, il est conseillé d’ajouter toutes les propriétés au dictionnaire à l’aide Save de l’inclusion de propriétés avec User la portée ou Shared , quelle que soit la portée de la page.It is a good practice, however, to add all properties to the dictionary using Save including properties with User or Shared scope, regardless of the scope of the page.

Le .NET Framework enregistre uniquement les propriétés avec Shared l’étendue, le cas échéant.The .NET Framework only saves the properties with Shared scope when appropriate. En d’autres termes, les propriétés partagées ne sont WebPart pas enregistrées lorsqu’un contrôle qui Shared a été ajouté à l’origine est ensuite enregistré User alors que la page est dans la portée.In other words, shared properties are not saved when a WebPart control that was initially added in Shared scope is later saved while the page is in User scope. Dans un scénario opposé, si un WebPart contrôle a été ajouté à la page User dans l’étendue et que le contrôle est enregistré par la suite alors Shared que la page est dans la portée, les valeurs des propriétés partagées personnalisées sont enregistrées (avec les propriétés de portée utilisateur personnalisées).In an opposite scenario, if a WebPart control was added to the page in User scope, and the control is later saved while the page is in Shared scope, custom shared property values are saved (along with custom user-scoped properties). Pour plus d’informations sur la personnalisation des données et sur la façon dont les propriétés partagées et de portée utilisateur sont affectées par la portée de personnalisation de la page, consultez la composants WebPart rubrique vue d’ensemble de la personnalisation.For details on personalization data and how shared and user-scoped properties are affected by the personalization scope of the page, see the Web Parts Personalization Overview topic.

Comme pour toute collection, cette méthode incrémente le nombre de collections d’une unité et tous les énumérateurs actuellement actifs sur la collection doivent être invalidés.As with any collection, this method increments the collection count by one and any enumerators currently active on the collection should be invalidated.

S’applique à

Voir aussi