Control.SaveViewState, méthode

L'état d'affichage est l'accumulation des valeurs de propriétés d'un contrôle serveur. Ces valeurs sont automatiquement placées dans la propriété d' ViewState du contrôle serveur, qui est une instance de la classe d' StateBag . Cette propriété est ensuite rendues persistantes dans un objet chaîne après l'étape d'état de sauvegarde du cycle de vie du contrôle serveur. Pour plus d'informations, consultez Introduction to the ASP.NET Page Life Cycle.

Lorsque l'état d'affichage est enregistré, cet objet chaîne est retourné au client comme variable qui est stockée dans un élément d' HIDDEN HTML. Lorsque vous créez un contrôle serveur personnalisé à un état d'affichage personnalisé, l'état d'affichage peut être géré explicitement avec les méthodes d' SaveViewState et d' LoadViewState . Pour plus d'informations, consultez ASP.NET State Management Overview. Pour plus d'informations sur l'implémentation d'un fournisseur d'états de session personnalisé, consultez Implementing a Session-State Store Provider.

L'exemple suivant substitue la méthode d' SaveViewState dans un contrôle serveur ASP.NET personnalisé. Lorsque cette méthode est appelée, elle détermine si le contrôle contient des contrôles enfants et si l'objet contenant d' Page est le résultat d'une publication. Si les deux sont vrais, il modifie la propriété d' Text d'un contrôle serveur Web d' Label pour lire Custom Control Has Saved State. Elle enregistre ensuite l'état d'affichage du contrôle comme un tableau d'objets, allStatesnommé.

protected override object SaveViewState()
{  // Change Text Property of Label when this function is invoked.
   if(HasControls() && (Page.IsPostBack))
   {
      ((Label)(Controls[0])).Text = "Custom Control Has Saved State";
   }
   // Save State as a cumulative array of objects.
   object baseState = base.SaveViewState();
   string userText = UserText;
   string passwordText = PasswordText;
   object[] allStates = new object[3];
   allStates[0] = baseState;
   allStates[1] = userText;
   allStates[2] = PasswordText;
   return allStates;
}

.NET Framework

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence

Autres ressources