PersonalizationDictionary.Add(String, PersonalizationEntry) Méthode

  • Référence

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 parties d’informations d’état personnalisées dans l’objet d’État et spécifier l’étendue associée à la valeur d’État. Quand un WebPartManager contrôle est dans la Shared portée, vous pouvez ajouter des informations de nom et d’état associées à l' Shared étendue ou à l' User étendue. Dans User étendue, vous pouvez ajouter des informations de nom et d’état associées uniquement à l' User étendue.

Toutefois, il est conseillé d’ajouter toutes les propriétés au dictionnaire à l’aide de l' Save inclusion de propriétés avec la User Shared portée ou, quelle que soit la portée de la page.

Le .NET Framework enregistre uniquement les propriétés avec l' 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 qui a été ajouté à l’origine Shared est ensuite enregistré alors que la page est dans la User portée. Dans un scénario opposé, si un WebPart contrôle a été ajouté à la page dans l' User étendue et que le contrôle est enregistré par la suite alors que la page est dans la Shared 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). 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 WebParts rubrique vue d’ensemble de la personnalisation.

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.

S’applique à

Voir aussi