Control.EnableViewState Control.EnableViewState Control.EnableViewState Control.EnableViewState Property

Определение

Получает или задает значение, указывающее запрашивающему клиенту, сохраняет ли серверный элемент управления состояние представления и состояние представления своих дочерних элементов управления.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

public:
 virtual property bool EnableViewState { bool get(); void set(bool value); };
[System.Web.UI.Themeable(false)]
public virtual bool EnableViewState { get; set; }
member this.EnableViewState : bool with get, set
Public Overridable Property EnableViewState As Boolean

Значение свойства

Значение true, если серверный элемент управления сохраняет состояние представления; в противном случае — значение false.true if the server control maintains its view state; otherwise false. Значение по умолчанию — true.The default is true.

Примеры

В следующем примере EnableViewState falseсвойству присваивается значение.The following example sets the EnableViewState property to false.

void Page_Load(object sender, System.EventArgs e)
{
      DataBind();
      // Set EnableViewState to false to disable saving of view state 
      // information.
      myControl.EnableViewState = false;
      if (!IsPostBack)
         display.Enabled = false;
      
}
Sub Page_Load(sender As Object, e As System.EventArgs)
   DataBind()
   ' Set EnableViewState to false to disable saving of view state 
   ' information.
   myControl.EnableViewState = False
   If Not IsPostBack Then
      display.Enabled = False
   End If 
End Sub

Комментарии

Состояние представления позволяет серверному элементу управления поддерживать свое состояние по HTTP-запросам.View state enables a server control to maintain its state across HTTP requests. Состояние представления для элемента управления включается, если выполняются все перечисленные ниже условия.View state for a control is enabled if all of the following conditions are met:

  • Свойству страницы присваивается trueзначение. EnableViewStateThe EnableViewState property for the page is set to true.

  • Свойству элемента управления присваивается trueзначение. EnableViewStateThe EnableViewState property for the control is set to true.

  • Свойству элемента управления Enabled присваивается или наследуется Enabled параметр. ViewStateModeThe ViewStateMode property for the control is set to Enabled or inherits the Enabled setting.

Дополнительные сведения см. в описании свойства ViewStateMode.For more information, see the ViewStateMode property.

Состояние представления серверного элемента управления — это совокупность значений всех его свойств.A server control's view state is the accumulation of all its property values. Чтобы сохранить эти значения в HTTP-запросах, ASP.NET использует экземпляр StateBag класса для хранения значений свойств.In order to preserve these values across HTTP requests, ASP.NET uses an instance of the StateBag class to store the property values. Значения затем передаются как переменные в скрытое поле при обработке последующих запросов.The values are then passed as a variable to a hidden field when subsequent requests are processed. Дополнительные сведения о состоянии представления см. в разделе Общие сведения о состоянии представления ASP.NET.For more information about view state, see ASP.NET View State Overview.

Бывают ситуации, когда необходимо отключить состояние представления, особенно для повышения производительности приложения.There are times when it is appropriate to disable view state, particularly to improve application performance. Например, если вы загружаете запрос к базе данных в серверный элемент управления, присвойте falseэтому свойству значение.For example, if you are loading a database request into a server control, set this property to false. В противном случае процессорное время будет задерживать загрузку состояния представления в серверный элемент управления, который будет переопределен только запросом к базе данных.If you do not, processor time will be wasted loading view state into the server control that will only be overridden by the database query. Если EnableViewState имеет falseзначение, можно использовать состояние элемента управления для сохранения сведений о свойствах, относящихся к элементу управления, и не может быть отключено как свойство состояния представления.If EnableViewState is false, you can use the control state to persist property information that is specific to a control and cannot be turned off like the view state property. Дополнительные сведения о разнице между состоянием элемента управления и состоянием представления см. в разделе Управление состоянием и Примерсостояния представления.For more information on the difference between control state and view state, see Control State vs. View State Example.

Сведения о том, как декларативно включать или отключать состояние представления для страницы ASP.NET, см. в разделе @ Page.For information about how to enable or disable view state declaratively for an ASP.NET page, see @ Page.

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

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