Control.EnableViewState Propriété

Définition

Espace de noms:

System.Web.UI

Assembly:

System.Web.dll

Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage, et l’état d’affichage de tous les contrôles enfants qu’il contient, au client demandeur.

public:
 virtual property bool EnableViewState { bool get(); void set(bool value); };

[System.Web.UI.Themeable(false)]
public virtual bool EnableViewState { get; set; }

[<System.Web.UI.Themeable(false)>]
member this.EnableViewState : bool with get, set

Public Overridable Property EnableViewState As Boolean

Valeur de propriété

Boolean

true si le contrôle serveur conserve son état d’affichage ; sinon, false. La valeur par défaut est true.

Attributs

ThemeableAttribute

Exemples

L’exemple suivant définit la EnableViewState propriété sur false.

void Page_Load(object sender, System.EventArgs e)
{
      DataBind();
      // Set EnableViewState to false to disable saving of view state 
      // information.
      myControl.EnableViewState = false;
      if (!IsPostBack)
         display.Enabled = false;
      
}

Sub Page_Load(sender As Object, e As System.EventArgs)
   DataBind()
   ' Set EnableViewState to false to disable saving of view state 
   ' information.
   myControl.EnableViewState = False
   If Not IsPostBack Then
      display.Enabled = False
   End If 
End Sub

Remarques

L’état d’affichage permet à un contrôle serveur de conserver son état dans les requêtes HTTP. L’état d’affichage d’un contrôle est activé si toutes les conditions suivantes sont remplies :

• La EnableViewState propriété de la page est définie sur true.

• La EnableViewState propriété du contrôle est définie sur true.

• La ViewStateMode propriété du contrôle est définie sur Enabled ou hérite du Enabled paramètre.

Pour plus d'informations, consultez la propriété ViewStateMode.

L’état d’affichage d’un contrôle serveur est l’accumulation de toutes ses valeurs de propriété. Pour conserver ces valeurs dans les requêtes HTTP, ASP.NET utilise une instance de la StateBag classe pour stocker les valeurs de propriété. Les valeurs sont ensuite passées en tant que variable à un champ masqué lorsque les demandes suivantes sont traitées. Pour plus d’informations sur l’état d’affichage, consultez ASP.NET Vue d’ensemble de l’état.

Il est parfois approprié de désactiver l’état d’affichage, en particulier pour améliorer les performances de l’application. Par exemple, si vous chargez une demande de base de données dans un contrôle serveur, définissez cette propriété sur false. Si ce n’est pas le cas, le temps processeur sera gaspiller pour charger l’état d’affichage dans le contrôle serveur qui sera remplacé uniquement par la requête de base de données. Si EnableViewState est false, vous pouvez utiliser l’état de contrôle pour conserver les informations de propriété spécifiques à un contrôle et ne peuvent pas être désactivées comme la propriété d’état d’affichage. Pour plus d’informations sur la différence entre l’état de contrôle et l’état d’affichage, consultez Exemple d’état de contrôle et d’état d’affichage.

Pour plus d’informations sur l’activation ou la désactivation de l’état d’affichage de manière déclarative pour une page ASP.NET, consultez @ Page.

Voir aussi

• ViewStateMode
• ViewState
• LoadViewState(Object)
• SaveViewState()
• IsViewStateEnabled
• Présentation du cycle de vie des pages ASP.NET
• Vue d’ensemble de la gestion de l’état ASP.NET
• État du contrôle et exemple d’état d’affichage