Control.EnableViewState Свойство

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.dll

Получает или задает значение, указывающее запрашивающему клиенту, сохраняет ли серверный элемент управления состояние представления и состояние представления своих дочерних элементов управления.

public:
 virtual property bool EnableViewState { bool get(); void set(bool value); };

[System.Web.UI.Themeable(false)]
public virtual bool EnableViewState { get; set; }

[<System.Web.UI.Themeable(false)>]
member this.EnableViewState : bool with get, set

Public Overridable Property EnableViewState As Boolean

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

Boolean

Значение true, если серверный элемент управления сохраняет состояние представления; в противном случае — значение false. Значение по умолчанию — true.

Атрибуты

ThemeableAttribute

Примеры

В следующем примере свойству присваивается EnableViewState значение 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-запросах. Состояние просмотра для элемента управления включено при выполнении всех следующих условий:

• Свойству EnableViewState страницы присвоено значение true.

• Свойство EnableViewState элемента управления имеет значение true.

• Свойство ViewStateMode элемента управления имеет значение Enabled или наследует Enabled параметр.

Дополнительные сведения см. в описании свойства ViewStateMode.

Состояние представления серверного элемента управления — это накопление всех его значений свойств. Чтобы сохранить эти значения в HTTP-запросах, ASP.NET использует экземпляр StateBag класса для хранения значений свойств. Затем значения передаются в виде переменной в скрытое поле при обработке последующих запросов. Дополнительные сведения о состоянии представления см. в ASP.NET Обзор состояния представления.

Иногда бывает целесообразно отключить состояние просмотра, особенно для повышения производительности приложения. Например, если вы загружаете запрос базы данных в серверный элемент управления, задайте для этого свойства значение false. Если этого не сделать, время процессора будет тратиться на загрузку состояния представления в серверный элемент управления, который будет переопределен только запросом к базе данных. Если EnableViewState имеет значение false, вы можете использовать состояние элемента управления для сохранения сведений о свойстве, относящихся к элементу управления и не отключаемых, как свойство состояния представления. Дополнительные сведения о различиях между состоянием элемента управления и состоянием представления см. в разделе Состояние элемента управления и пример состояния представления.

Сведения о том, как декларативно включить или отключить состояние просмотра для страницы ASP.NET, см. в разделе @ Page.

См. также раздел

• ViewStateMode
• ViewState
• LoadViewState(Object)
• SaveViewState()
• IsViewStateEnabled
• Общие сведения о жизненном цикле страницы ASP.NET
• Общие сведения об управлении состоянием ASP.NET
• Пример состояния элемента управления и состояния просмотра