Control.EnableViewState Propriété

Référence

Définition

Espace de noms:: System.Web.UI

Assembly:: System.Web.dll

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.

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); };

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 :

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é lors du traitement des demandes suivantes. Pour plus d’informations sur l’état d’affichage, consultez ASP.NET Vue d’ensemble de l’état d’affichage.

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 perdu pour charger l’état d’affichage dans le contrôle serveur qui sera uniquement remplacé par la requête de base de données. Si EnableViewState a la valeur false, vous pouvez utiliser l’état du contrôle pour conserver les informations de propriété spécifiques à un contrôle et qui 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 État du contrôle et Exemple 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.

S’applique à

Partager via