WebPart.SetPersonalizationDirty, méthode

La méthode SetPersonalizationDirty définit un indicateur qui spécifie que les données d'état du contrôle ont été modifiées (personnalisées) sur un contrôle WebPart, et que le contrôle WebPartManager doit par conséquent rendre les données de personnalisation persistantes dans un stockage à long terme.

Normalement, le WebPartManager rend les personnalisations persistantes sur les contrôles WebPart sans que les développeurs doivent appeler la méthode SetPersonalizationDirty. Mais dans deux cas de figures, les développeurs doivent appeler cette méthode. Le premier cas est lorsque les données d'état du contrôle sont modifiées pendant une demande de GET HTTP à une page. Par défaut, les modifications apportées aux données d'état du contrôle pendant une demande GET ne sont pas rendues persistantes (pour des raisons de sécurité). Mais la méthode SetPersonalizationDirty permet de rendre persistantes des personnalisations légitimes dans les contrôles WebPart de ce cas.

Le deuxième cas où la méthode SetPersonalizationDirty est appelée se produit pendant une demande POST HTTP à une page. Si un contrôle WebPart a des propriétés personnalisables complexes (par exemple, une propriété qui contient un objet ArrayList), et que les données d'état du contrôle de ces propriétés sont personnalisées pendant une demande POST, les développeurs doivent appeler la méthode SetPersonalizationDirty pour garantir que les modifications sont rendues persistantes.

.NET Framework

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence

Autres ressources