Control.EnableViewState Właściwość

Definicja

Pobiera lub ustawia wartość wskazującą, czy formant serwera utrzymuje stan widoku, oraz stan widoku wszystkich formantów podrzędnych, które zawiera, do żądającego klienta.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

Wartość właściwości

true, jeśli formant serwera utrzymuje stan widoku; w przeciwnym razie false.true if the server control maintains its view state; otherwise false. Wartość domyślna to true.The default is true.

Atrybuty

Przykłady

Poniższy przykład ustawia właściwość EnableViewState na 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

Uwagi

Stan widoku umożliwia formantowi serwera zachowanie jego stanu w żądaniach HTTP.View state enables a server control to maintain its state across HTTP requests. Stan widoku kontrolki jest włączony w przypadku spełnienia wszystkich następujących warunków:View state for a control is enabled if all of the following conditions are met:

Aby uzyskać więcej informacji, zobacz Właściwość ViewStateMode.For more information, see the ViewStateMode property.

Stan widoku kontrolki serwera to akumulacja wszystkich wartości właściwości.A server control's view state is the accumulation of all its property values. Aby zachować te wartości w żądaniach HTTP, ASP.NET używa wystąpienia klasy StateBag do przechowywania wartości właściwości.In order to preserve these values across HTTP requests, ASP.NET uses an instance of the StateBag class to store the property values. Wartości są następnie przenoszone jako zmienna do ukrytego pola, gdy kolejne żądania są przetwarzane.The values are then passed as a variable to a hidden field when subsequent requests are processed. Aby uzyskać więcej informacji o stanie widoku, zobacz przegląd stanu widoku ASP.NET.For more information about view state, see ASP.NET View State Overview.

Istnieją przypadki, w których konieczne jest wyłączenie stanu widoku, szczególnie w celu zwiększenia wydajności aplikacji.There are times when it is appropriate to disable view state, particularly to improve application performance. Na przykład w przypadku ładowania żądania bazy danych do formantu serwera należy ustawić tę właściwość na false.For example, if you are loading a database request into a server control, set this property to false. W przeciwnym razie czas procesora będzie tracić stan widoku ładowania do formantu serwera, który zostanie zastąpiony przez zapytanie bazy danych.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. Jeśli EnableViewState jest false, można użyć stanu formantu do utrwalania informacji o właściwościach, które są specyficzne dla kontrolki i nie można jej wyłączyć, podobnie jak właściwość widoku stanu.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. Aby uzyskać więcej informacji na temat różnic między stanem kontroli i stanem widoku, zobacz stan kontroli a przykład stanu widoku.For more information on the difference between control state and view state, see Control State vs. View State Example.

Aby uzyskać informacje na temat sposobu włączania lub wyłączania stanu widoku dla strony ASP.NET, zobacz stronę@.For information about how to enable or disable view state declaratively for an ASP.NET page, see @ Page.

Dotyczy

Zobacz też