Control.SaveViewState Control.SaveViewState Control.SaveViewState Control.SaveViewState Method

Definizione

Salva eventuali modifiche dello stato di visualizzazione di un controllo server apportate dopo il postback della pagina nel server.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

Restituisce

Restituisce lo stato di visualizzazione corrente del controllo server.Returns the server control's current view state. Se al controllo non è associato alcuno stato di visualizzazione, questo metodo restituisce null.If there is no view state associated with the control, this method returns null.

Esempi

Nell'esempio seguente viene eseguito SaveViewState l'override del metodo in un controllo server ASP.NET personalizzato.The following example overrides the SaveViewState method in a custom ASP.NET server control. Quando viene richiamato, questo metodo determina se il controllo dispone di controlli figlio e se l'oggetto Page contenitore è il risultato di 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. Se entrambi sono true, la Text proprietà di un Label controllo server Web viene modificata in lettura 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. Salva quindi lo stato di visualizzazione del controllo sotto forma di matrice di oggetti, denominati 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

Commenti

Lo stato di visualizzazione è l'accumulo dei valori delle proprietà di un controllo server.View state is the accumulation of the values of a server control's properties. Questi valori vengono inseriti automaticamente nella ViewState proprietà del controllo server, che è un'istanza StateBag della classe.These values are automatically placed in the server control's ViewState property, which is an instance of the StateBag class. Il valore di questa proprietà viene quindi salvato in modo permanente in un oggetto stringa dopo la fase Salva stato del ciclo di vita del controllo server.This property's value is then persisted to a string object after the save state stage of the server control life cycle. Per altre informazioni, vedere Panoramica del ciclo di vita della pagina ASP.NET.For more information, see ASP.NET Page Life Cycle Overview.

Quando viene salvato lo stato di visualizzazione, questo oggetto stringa viene restituito al client come variabile archiviata in 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. Quando si crea un controllo server personalizzato con uno stato di visualizzazione personalizzato, lo stato di visualizzazione può essere gestito in modo SaveViewState esplicito con i metodi e 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. Per altre informazioni, vedere Panoramica della gestione dello stato di ASP.NET.For more information, see ASP.NET State Management Overview. Per informazioni sull'implementazione di un provider di stato della sessione personalizzato, vedere implementazione di un provider di archiviazione dello stato sessione.For information on implementing a custom session-state provider, see Implementing a Session-State Store Provider.

Si applica a

Vedi anche