WebPart.SetPersonalizationDirty 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.
Définit un indicateur qui spécifie que les données de personnalisation ont changé pour un contrôle WebPart ou un contrôle serveur placé dans une zone WebPartZoneBase.
Surcharges
| SetPersonalizationDirty(Control) |
Définit un indicateur qui spécifie que les données de personnalisation ont changé pour le contrôle serveur spécifié qui réside dans une zone WebPartZoneBase. |
| SetPersonalizationDirty() |
Définit un indicateur qui signale que les données de personnalisation ont changé pour l'instance de contrôle WebPart en cours. |
SetPersonalizationDirty(Control)
Définit un indicateur qui spécifie que les données de personnalisation ont changé pour le contrôle serveur spécifié qui réside dans une zone WebPartZoneBase.
public:
static void SetPersonalizationDirty(System::Web::UI::Control ^ control);public static void SetPersonalizationDirty (System.Web.UI.Control control);static member SetPersonalizationDirty : System.Web.UI.Control -> unitPublic Shared Sub SetPersonalizationDirty (control As Control)Paramètres
Exceptions
L'objet contenu dans le paramètre control est null.
Le contrôle n'est pas associé à une page.
- ou -
Le contrôle dérive de WebPart. Les contrôles qui dérivent de WebPart doivent utiliser à la place la méthode SetPersonalizationDirty() protégée.
La page associée au contrôle ne possède pas de WebPartManager.
Remarques
La WebPart.SetPersonalizationDirty méthode a le même objectif que la WebPart.SetPersonalizationDirty() méthode, qui est de définir un indicateur indiquant que les données d’état de contrôle ont été modifiées (personnalisées) sur un contrôle serveur pendant une requête HTTP GET . La différence entre ces méthodes est que la WebPart.SetPersonalizationDirty méthode est utilisée pour les contrôles serveur qui n’héritent pas de la WebPart classe, mais qui sont placés dans WebPartZoneBase des zones pour participer à des applications WebPart.
Voir aussi
S’applique à
SetPersonalizationDirty()
Définit un indicateur qui signale que les données de personnalisation ont changé pour l'instance de contrôle WebPart en cours.
protected:
void SetPersonalizationDirty();protected void SetPersonalizationDirty ();member this.SetPersonalizationDirty : unit -> unitProtected Sub SetPersonalizationDirty ()Exceptions
WebPartManager a la valeur null.
Remarques
La SetPersonalizationDirty méthode définit un indicateur indiquant que les données d’état du contrôle ont été modifiées (personnalisées) sur un WebPart contrôle et que le WebPartManager contrôle doit donc conserver les données de personnalisation dans un stockage à long terme.
Normalement, le WebPartManager conserve les modifications de personnalisation sur WebPart les contrôles sans que les développeurs n’ont besoin d’appeler la SetPersonalizationDirty méthode . Mais il existe deux cas dans lesquels les développeurs doivent appeler cette méthode. Le premier cas est lorsque les données d’état de contrôle sont modifiées lors d’une requête HTTP GET vers une page. Par défaut, les modifications apportées au contrôle des données d’état pendant une GET demande ne sont pas conservées (pour des raisons de sécurité). Toutefois, la SetPersonalizationDirty méthode fournit un moyen de conserver les modifications de personnalisation légitimes apportées aux WebPart contrôles dans ce cas.
Le deuxième cas d’appel de la SetPersonalizationDirty méthode se produit lors d’une requête HTTP POST à une page. Si un WebPart contrôle a des propriétés personnalisables complexes (telles qu’une propriété qui contient un objet) et que les données d’état ArrayList de contrôle dans ces propriétés sont personnalisées lors d’une POST demande, les développeurs doivent appeler la SetPersonalizationDirty méthode pour s’assurer que les modifications sont conservées.
