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 indiquant que les données de personnalisation ont changé pour un contrôle WebPart ou un contrôle serveur placé dans une WebPartZoneBase zone.
Surcharges
| Nom | Description |
|---|---|
| SetPersonalizationDirty(Control) |
Définit un indicateur indiquant que les données de personnalisation ont changé pour le contrôle serveur spécifié qui réside dans une WebPartZoneBase zone. |
| SetPersonalizationDirty() |
Définit un indicateur indiquant que les données de personnalisation ont changé pour l’instance de contrôle actuelle WebPart . |
SetPersonalizationDirty(Control)
Définit un indicateur indiquant que les données de personnalisation ont changé pour le contrôle serveur spécifié qui réside dans une WebPartZoneBase zone.
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 dans le control paramètre 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 méthode protégée SetPersonalizationDirty() à la place.
La page associée au contrôle n’a pas de WebPartManager.
Remarques
La WebPart.SetPersonalizationDirty méthode a le même objectif que la WebPart.SetPersonalizationDirty() méthode, qui consiste à définir un indicateur indiquant que les données d’état du 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 des WebPartZoneBase zones pour participer aux applications de composants WebPart.
Voir aussi
S’applique à
SetPersonalizationDirty()
Définit un indicateur indiquant que les données de personnalisation ont changé pour l’instance de contrôle actuelle WebPart .
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 le stockage à long terme.
Normalement, les WebPartManager modifications de personnalisation persistantes sur WebPart les contrôles n’ont pas besoin que les développeurs appellent la SetPersonalizationDirty méthode. Toutefois, il existe deux cas dans lesquels les développeurs doivent appeler cette méthode. Le premier cas est le moment où les données d’état du contrôle sont modifiées pendant une requête HTTP GET vers une page. Par défaut, les modifications apportées aux données d’état pendant une GET demande ne sont pas conservées (à des fins de sécurité). Toutefois, la SetPersonalizationDirty méthode permet 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 pendant une requête HTTP POST vers 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 pendant une POST demande, les développeurs doivent appeler la SetPersonalizationDirty méthode pour s’assurer que les modifications sont conservées.
