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

Definition

Speichert alle Ansichtszustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde.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

Gibt zurück

Gibt den aktuellen Ansichtszustand des Serversteuerelements zurück.Returns the server control's current view state. Wenn dem Steuerelement kein Ansichtszustand zugeordnet ist, gibt diese Methode null zurück.If there is no view state associated with the control, this method returns null.

Beispiele

Im folgenden Beispiel wird die SaveViewState -Methode in einem benutzerdefinierten ASP.NET-Server Steuerelement überschrieben.The following example overrides the SaveViewState method in a custom ASP.NET server control. Wenn diese Methode aufgerufen wird, bestimmt Sie, ob das Steuerelement über untergeordnete Steuerelemente verfügt Page und ob das enthaltende Objekt das Ergebnis eines Postbacks ist.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. Wenn beide "true" sind, wird Text die-Eigenschaft Label eines Webserver Steuer Elements in Custom Control Has Saved State"Read" geändert.If both are true, it changes the Text property of a Label Web server control to read Custom Control Has Saved State. Anschließend wird der Ansichts Zustand des Steuer Elements als Array von-Objekten mit dem allStatesNamen gespeichert.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

Hinweise

Der Ansichts Zustand ist die Ansammlung der Werte der Eigenschaften eines Server Steuer Elements.View state is the accumulation of the values of a server control's properties. Diese Werte werden automatisch in die-Eigenschaft des Server ViewState Steuer Elements eingefügt, bei der es sich StateBag um eine Instanz der-Klasse handelt.These values are automatically placed in the server control's ViewState property, which is an instance of the StateBag class. Der Wert dieser Eigenschaft wird dann in einem String-Objekt nach der Phase Zustands speichern des Lebenszyklus des Server Steuer Elements persistent gespeichert.This property's value is then persisted to a string object after the save state stage of the server control life cycle. Weitere Informationen finden Sie unter ASP.net page Lifecycle Overview.For more information, see ASP.NET Page Life Cycle Overview.

Wenn der Ansichts Zustand gespeichert wird, wird dieses Zeichen folgen Objekt als Variable, die in einem HTML HIDDEN --Element gespeichert ist, an den Client zurückgegeben.When view state is saved, this string object is returned to the client as a variable that is stored in an HTML HIDDEN element. Wenn Sie ein benutzerdefiniertes Server Steuerelement mit einem benutzerdefinierten Ansichts Zustand erstellen, kann der Ansichts SaveViewState Zustand LoadViewState explizit mit den Methoden und verwaltet werden.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. Weitere Informationen finden Sie unter ASP.net State Management Overview.For more information, see ASP.NET State Management Overview. Weitere Informationen zum Implementieren eines benutzerdefinierten Sitzungs Zustands Anbieters finden Sie unter Implementieren eines Sitzungs Zustands Speicher-Anbieters.For information on implementing a custom session-state provider, see Implementing a Session-State Store Provider.

Gilt für:

Siehe auch