Control.SaveViewState Méthode

Définition

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.Saves any server control view-state changes that have occurred since the time the page was posted back to the server.

protected:
 virtual System::Object ^ SaveViewState();
protected virtual object SaveViewState ();
abstract member SaveViewState : unit -> obj
override this.SaveViewState : unit -> obj
Protected Overridable Function SaveViewState () As Object

Retours

Object

Retourne l’état d’affichage actuel du contrôle serveur.Returns the server control's current view state. Si aucun état d’affichage n’est associé au contrôle, cette méthode retourne null.If there is no view state associated with the control, this method returns null.

Exemples

L’exemple suivant substitue la SaveViewState méthode dans un contrôle serveur ASP.NET personnalisé.The following example overrides the SaveViewState method in a custom ASP.NET server control. Quand cette méthode est appelée, elle détermine si le contrôle a des contrôles enfants et si l’objet conteneur Page est le résultat d’une publication (postback).When this method is invoked, it determines whether the control has any child controls and whether the containing Page object is the result of a postback. Si les deux ont la valeur true, la Text propriété d’un Label contrôle serveur Web est modifiée pour être lue Custom Control Has Saved State .If both are true, it changes the Text property of a Label Web server control to read Custom Control Has Saved State. Elle enregistre ensuite l’état d’affichage du contrôle sous la forme d’un tableau d’objets, nommé allStates .It then saves the view state of the control as an array of objects, named 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;
}
Protected Overrides Function SaveViewState() As Object
   ' Change Text Property of Label when this function is invoked.
   If HasControls() And Page.IsPostBack Then
      CType(Controls(0), Label).Text = "Custom Control Has Saved State"
   End If
   ' Save State as a cumulative array of objects.
   Dim baseState As Object = MyBase.SaveViewState()
   Dim _userText As String = UserText
   Dim _passwordText As String = PasswordText
   Dim allStates(3) As Object
   allStates(0) = baseState
   allStates(1) = _userText
   allStates(2) = PasswordText
   Return allStates
End Function

Remarques

L’état d’affichage est l’accumulation des valeurs des propriétés d’un contrôle serveur.View state is the accumulation of the values of a server control's properties. Ces valeurs sont automatiquement placées dans la propriété du contrôle serveur ViewState , qui est une instance de la StateBag classe.These values are automatically placed in the server control's ViewState property, which is an instance of the StateBag class. La valeur de cette propriété est ensuite rendue persistante dans un objet String après l’étape d’enregistrement de l’état du cycle de vie du contrôle serveur.This property's value is then persisted to a string object after the save state stage of the server control life cycle. Pour plus d’informations, consultez vue d’ensemble du cycle de vie d’une Page ASP.net.For more information, see ASP.NET Page Life Cycle Overview.

Lorsque l’état d’affichage est enregistré, cet objet String est retourné au client sous la forme d’une variable stockée dans un HIDDEN élément HTML.When view state is saved, this string object is returned to the client as a variable that is stored in an HTML HIDDEN element. Lorsque vous créez un contrôle serveur personnalisé avec un état d’affichage personnalisé, l’état d’affichage peut être géré explicitement à l’aide des SaveViewState LoadViewState méthodes et.When you author a custom server control with a custom view state, the view state can be managed explicitly with the SaveViewState and LoadViewState methods. Pour plus d’informations, consultez vue d’ensemble de la gestion d’état ASP.net.For more information, see ASP.NET State Management Overview. Pour plus d’informations sur l’implémentation d’un fournisseur d’état de session personnalisé, consultez implémentation d’un fournisseur de magasins d’état de session.For information on implementing a custom session-state provider, see Implementing a Session-State Store Provider.

S’applique à

Voir aussi