Control.EnableViewState Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera utrzymuje stan widoku, oraz stan widoku wszystkich kontrolek podrzędnych, które zawiera, do klienta żądającego.

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

Wartość właściwości

Boolean

true jeśli kontrola serwera zachowuje stan widoku; w przeciwnym razie false. Wartość domyślna to true.

Atrybuty: ThemeableAttribute

Przykłady

Poniższy przykład ustawia EnableViewState właściwość na falsewartość .

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 sterowanie serwerem w celu zachowania stanu między żądaniami HTTP. Stan widoku dla kontrolki jest włączony, jeśli zostaną spełnione wszystkie następujące warunki:

Właściwość strony jest ustawiona EnableViewState na truewartość .
Właściwość kontrolki jest ustawiona EnableViewState na true.
Właściwość ViewStateMode kontrolki jest ustawiona na Enabled lub dziedziczy Enabled ustawienie.

Aby uzyskać więcej informacji, zobacz ViewStateMode właściwość .

Stan widoku kontrolki serwera to akumulacja wszystkich jego wartości właściwości. Aby zachować te wartości w żądaniach HTTP, ASP.NET używa wystąpienia StateBag klasy do przechowywania wartości właściwości. Wartości są następnie przekazywane jako zmienna do ukrytego pola po przetworzeniu kolejnych żądań. Aby uzyskać więcej informacji na temat stanu widoku, zobacz temat ASP.NET View State Overview (Przegląd stanu widoku).

Czasami należy wyłączyć stan wyświetlania, szczególnie w celu zwiększenia wydajności aplikacji. Jeśli na przykład ładujesz żądanie bazy danych do kontrolki serwera, ustaw tę właściwość na false. Jeśli tego nie zrobisz, czas procesora zostanie zmarnowany stan widoku ładowania do kontrolki serwera, która zostanie zastąpiona tylko przez zapytanie bazy danych. Jeśli EnableViewState jest to false, możesz użyć stanu kontrolki, aby utrwały informacje o właściwości specyficzne dla kontrolki i nie można jej wyłączyć, podobnie jak właściwość stanu widoku. Aby uzyskać więcej informacji na temat różnicy między stanem kontroli i stanem widoku, zobacz Stan kontroli a Przykład stanu widoku.

Aby uzyskać informacje o sposobie włączania lub wyłączania stanu widoku deklaratywnie dla strony ASP.NET, zobacz @ Strona.

Dotyczy