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.

Атрибуты

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
• Управление состоянием и примером состояния представления