Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Control.SaveViewState méthode ()

 

Date de publication : novembre 2016

Enregistre les changements d’état d’affichage du contrôle serveur qui se sont produits depuis que la page a été republiée sur le serveur.

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

protected virtual object SaveViewState()

Valeur de retour

Type: System.Object

Retourne l’état d’affichage actuel du contrôle serveur. Si aucun état d’affichage n’est associé au contrôle, cette méthode retourne null.

État d’affichage est l’accumulation des valeurs de propriétés d’un contrôle serveur. Ces valeurs sont automatiquement placées dans le contrôle de serveur ViewState propriété, qui est une instance de la StateBag classe. Valeur de cette propriété est ensuite rendue persistante dans un objet chaîne après l’enregistrement étape du cycle de vie du contrôle serveur. Pour plus d'informations, consultez ASP.NET Page Life Cycle Overview.

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

L’exemple suivant remplace la SaveViewState méthode dans un contrôle de serveur ASP.NET personnalisé. Lorsque cette méthode est appelée, elle détermine si le contrôle a des contrôles enfants et si la contenant Page objet est le résultat d’une publication (postback). Si les deux sont vraies, il modifie le Text propriété d’un Label en contrôle de serveur Web Custom Control Has Saved State. Elle enregistre ensuite l’état d’affichage du contrôle comme un tableau d’objets, nommé allStates.

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
Disponible depuis 1.1
Retour au début
Afficher: