Control.SaveViewState Método

Definición

Guarda los cambios realizados en el estado de vista del control de servidor desde que la página volvió a publicarse en el servidor.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

Devoluciones

Devuelve el estado de vista actual del control de servidor.Returns the server control's current view state. Si no hay ningún estado de vista asociado al control, este método devuelve null.If there is no view state associated with the control, this method returns null.

Ejemplos

En el ejemplo siguiente se invalida el método SaveViewState en un control de servidor ASP.NET personalizado.The following example overrides the SaveViewState method in a custom ASP.NET server control. Cuando se invoca este método, determina si el control tiene controles secundarios y si el objeto contenedor Page es el resultado de un 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 ambos son true, cambia la propiedad Text de un control de servidor Web Label para que se lea 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. A continuación, guarda el estado de vista del control como una matriz de objetos, denominada 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

Comentarios

El estado de vista es la acumulación de los valores de las propiedades de un control de servidor.View state is the accumulation of the values of a server control's properties. Estos valores se colocan automáticamente en la propiedad ViewState del control de servidor, que es una instancia de la clase StateBag.These values are automatically placed in the server control's ViewState property, which is an instance of the StateBag class. Después, el valor de esta propiedad se conserva en un objeto de cadena después de la fase de guardado del estado del ciclo de vida del control de servidor.This property's value is then persisted to a string object after the save state stage of the server control life cycle. Para obtener más información, consulte información general del ciclo de vida de la página ASP.net.For more information, see ASP.NET Page Life Cycle Overview.

Cuando se guarda el estado de vista, este objeto de cadena se devuelve al cliente como una variable que se almacena en un elemento HTML HIDDEN.When view state is saved, this string object is returned to the client as a variable that is stored in an HTML HIDDEN element. Al crear un control de servidor personalizado con un estado de vista personalizado, el estado de vista se puede administrar explícitamente con los métodos SaveViewState y LoadViewState.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. Para obtener más información, vea información general sobre la administración de estado de ASP.net.For more information, see ASP.NET State Management Overview. Para obtener información sobre cómo implementar un proveedor de estado de sesión personalizado, vea implementar un proveedor de almacén de Estados de sesión.For information on implementing a custom session-state provider, see Implementing a Session-State Store Provider.

Se aplica a

Consulte también: