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

Определение

Сохраняет любые изменения состояния просмотра серверного элемента управления, произошедшие после отправки страницы обратно на сервер.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

Возвраты

Возвращает текущее состояние просмотра серверного элемента управления.Returns the server control's current view state. Если нет состояния просмотра, связанного с этим элементом управления, этот метод возвращает null.If there is no view state associated with the control, this method returns null.

Примеры

В следующем примере переопределяется SaveViewState метод в пользовательском серверном элементе управления ASP.NET.The following example overrides the SaveViewState method in a custom ASP.NET server control. При вызове этого метода он определяет, имеет ли элемент управления дочерние элементы управления и является ли Page содержащий его результат обратной передачи.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. Если оба значения имеют значение true, Text свойство Label элемента управления веб-сервера будет изменено Custom Control Has Saved Stateна Read.If both are true, it changes the Text property of a Label Web server control to read Custom Control Has Saved State. Затем он сохраняет состояние представления элемента управления в виде массива объектов с именем 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

Комментарии

Состояние представления — это совокупность значений свойств серверного элемента управления.View state is the accumulation of the values of a server control's properties. Эти значения автоматически помещаются в ViewState свойство серверного элемента управления, которое является экземпляром StateBag класса.These values are automatically placed in the server control's ViewState property, which is an instance of the StateBag class. Затем значение этого свойства сохраняется в строковом объекте после этапа сохранения состояния жизненного цикла серверного элемента управления.This property's value is then persisted to a string object after the save state stage of the server control life cycle. Дополнительные сведения см. в разделе Общие сведения о жизненном цикле страницы ASP.NET.For more information, see ASP.NET Page Life Cycle Overview.

При сохранении состояния представления этот строковый объект возвращается клиенту в виде переменной, хранящейся в 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. При создании пользовательского серверного элемента управления с пользовательским состоянием представления можно явно управлять состоянием представления с SaveViewState помощью методов и. LoadViewStateWhen you author a custom server control with a custom view state, the view state can be managed explicitly with the SaveViewState and LoadViewState methods. Дополнительные сведения см. в разделе Обзор управления состоянием ASP.NET.For more information, see ASP.NET State Management Overview. Сведения о реализации пользовательского поставщика состояния сеанса см. в разделе Реализация поставщика хранилища состояний сеанса.For information on implementing a custom session-state provider, see Implementing a Session-State Store Provider.

Применяется к

Дополнительно