Partager via

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 des contrôles enfants qu’il contient, au client demandeur.

public:
 virtual property bool EnableViewState { bool get(); void set(bool value); };
public virtual bool EnableViewState { get; set; }
[System.Web.UI.Themeable(false)]
public virtual bool EnableViewState { get; set; }
member this.EnableViewState : bool with 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 sur les requêtes HTTP. L’état d’affichage d’un contrôle est activé si toutes les conditions suivantes sont remplies :

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

L’état d’affichage d’un contrôle de serveur est l’accumulation de toutes ses valeurs de propriété. Pour conserver ces valeurs entre 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 requêtes suivantes sont traitées. Pour plus d’informations sur l’état d’affichage, consultez ASP.NET Vue d’ensemble de l’état d’affichage.

Il existe des moments où il est 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é falsesur . Si ce n’est pas le cas, le temps processeur sera gaspiller l’état d’affichage du chargement dans le contrôle serveur qui ne sera substitué que par la requête de base de données. Si EnableViewState c’est falsele cas, vous pouvez utiliser l’état du contrôle pour conserver les informations de propriété spécifiques à un contrôle et ne peut pas être désactivée 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 l’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, voir @ Page.

S’applique à

Voir aussi