IVersioningPersonalizable.Load(IDictionary) Méthode

Définition

Espace de noms:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Charge les données de personnalisation dans un contrôle WebPart qui n’a pas de propriété personnalisée correspondante pour les données en raison d’un changement de version.

public:
 void Load(System::Collections::IDictionary ^ unknownProperties);

public void Load (System.Collections.IDictionary unknownProperties);

abstract member Load : System.Collections.IDictionary -> unit

Public Sub Load (unknownProperties As IDictionary)

Paramètres

unknownProperties

IDictionary

Dictionnaire de données de personnalisation qui n’ont pas pu être appliquées à un contrôle.

Remarques

Le unknownProperties paramètre contient une représentation fusionnée de données de personnalisation inconnues, d’étendue « Utilisateur » et « Partagé », qui n’a pas pu être appliquée au contrôle. Lorsqu’une page s’exécute dans l’étendue utilisateur, les valeurs d’étendue utilisateur inconnues sont fournies (si disponibles) plutôt que les valeurs d’étendue partagée inconnues. Ces informations sont stockées sous la forme d’une série de paires nom/valeur où chaque nom est le nom de chaîne d’une propriété introuvable sur le contrôle et chaque valeur contient la valeur de la propriété. Il incombe au contrôle de caster ou de convertir la valeur en type approprié et d’effectuer un traitement ultérieur (par exemple, le mappage de données d’une ancienne propriété vers une nouvelle propriété).

Si l’état d’un contrôle change, il doit appeler SetPersonalizationDirty (soit la méthode héritée, soit la méthode statique publique dans le cas d’un contrôle qui ne dérive pas de WebPart). Si un contrôle se marque lui-même comme « sale », le jeu de contrôles WebPart extrait les données de personnalisation du contrôle, quel que soit l’état « sale » du contrôle, et les enregistre dans le magasin de données sous-jacent plus tard dans le cycle de vie de la personnalisation. Un contrôle doit se marquer comme « sale » si, à la suite du traitement des valeurs dans le unknownProperties paramètre, l’état du contrôle a changé.

Notez que si des propriétés orphelines sont détectées lors de l’importation de contrôles WebPart, cette méthode est automatiquement appelée.