Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.

Traduction

Source

Ce sujet n'a pas encore été évalué - Évaluez ce sujet

Control.EnableViewState, propriété

.NET Framework 4

Autres versions

Obtient ou définit une valeur indiquant si le contrôle serveur rend persistant son état d'affichage, ainsi que celui de tous les contrôles enfants qu'il contient, sur le client à l'origine de la demande.

Espace de noms : System.Web.UI
Assembly : System.Web (dans System.Web.dll)

Syntaxe

C++

Copier

[ThemeableAttribute(false)]
public virtual bool EnableViewState { get; set; }

Valeur de propriété

Type : System.Boolean
true si le contrôle serveur conserve son état d'affichage ; sinon, false. La valeur par défaut est true.

Notes

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

La propriété EnableViewState pour la page a la valeur true.
La propriété EnableViewState pour le contrôle a la valeur true.
La propriété ViewStateMode du contrôle a la valeur Enabled ou hérite du paramètre Enabled.

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

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

Il peut parfois être utile de désactiver l'état d'affichage, particulièrement 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, affectez false à cette propriété. Sinon, vous gaspillez du temps processeur en chargeant dans le contrôle serveur l'état d'affichage qui est ensuite substitué par la requête de base de données. Si EnableViewState est false, vous pouvez utiliser l'état du contrôle pour rendre persistantes les informations de propriété qui sont 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 du contrôle et l'état d'affichage, consultez Comparaison entre états de contrôle et états d'affichage, exemple.

Pour plus d'informations sur l'activation ou la désactivation de l'état d'affichage par déclaration pour une page ASP.NET, consultez @ Page.

Exemples

L'exemple suivant montre comment affecter false à la propriété EnableViewState.

Copier


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;

}

Informations de version

.NET Framework

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

Plateformes

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Voir aussi