IVersioningPersonalizable.Load(IDictionary) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Charge les données de personnalisation dans un contrôle De composants WebPart qui n’a pas de propriété personnalisée correspondante pour les données en raison d’une modification de version.
public:
void Load(System::Collections::IDictionary ^ unknownProperties);public void Load(System.Collections.IDictionary unknownProperties);abstract member Load : System.Collections.IDictionary -> unitPublic 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 des données de personnalisation inconnues, de l’étendue « Utilisateur » et « Partagé », qui n’a pas pu être appliquée au contrôle. Lorsqu’une page s’exécute dans l’étendue de l’utilisateur, les valeurs d’étendue utilisateur inconnues sont fournies (le cas échéant) 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 propriété. Il incombe au contrôle de convertir ou de convertir la valeur en type approprié et d’effectuer un traitement supplémentaire (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 comme étant « sale », le jeu de contrôles Composants WebPart extrait les données de personnalisation du contrôle, quel que soit l’état « sale » du contrôle, puis l’enregistre dans le magasin de données sous-jacent plus tard dans le cycle de vie de personnalisation. Un contrôle doit se marquer comme étant « 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.
