Control.EnableViewState Свойство

Определение

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

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

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

Boolean

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

Атрибуты

Примеры

В следующем примере свойству 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 View State Overview.

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

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

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

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