Control.EnableViewState Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví hodnotu určující, zda serverový ovládací prvek zachová svůj stav zobrazení a stav zobrazení všech podřízených ovládacích prvků, které obsahuje, pro žádajícího klienta.

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

Hodnota vlastnosti

Boolean

true pokud si ovládací prvek serveru udržuje svůj stav zobrazení; jinak false. Výchozí formát je true.

Atributy: ThemeableAttribute

Příklady

Následující příklad nastaví EnableViewState vlastnost na 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

Poznámky

Zobrazení stavu umožňuje serverovým ovládacím prvkům udržovat svůj stav napříč požadavky HTTP. Zobrazení stavu ovládacího prvku je povoleno, pokud jsou splněny všechny následující podmínky:

Vlastnost EnableViewState stránky je nastavená na true.
Vlastnost EnableViewState ovládacího prvku je nastavena na true.
Vlastnost ViewStateMode ovládacího prvku je nastavená na Enabled hodnotu nebo zdědí Enabled nastavení.

Další informace najdete ve ViewStateMode vlastnosti.

Stav zobrazení serverového ovládacího prvku je akumulace všech hodnot jeho vlastností. Aby bylo možné zachovat tyto hodnoty napříč požadavky HTTP, ASP.NET používá instanci StateBag třídy k uložení hodnot vlastností. Hodnoty se pak předají jako proměnná do skrytého pole při zpracování následných požadavků. Další informace o stavu zobrazení najdete v tématu ASP.NET Přehled stavu zobrazení.

Někdy je vhodné stav zobrazení zakázat, zejména kvůli zvýšení výkonu aplikace. Pokud například načítáte požadavek databáze do serverového ovládacího prvku, nastavte tuto vlastnost na false. Pokud to neuděláte, bude čas procesoru plýtván načítáním stavu zobrazení do serverového ovládacího prvku, který bude přepsán pouze databázovým dotazem. Pokud EnableViewState je false, můžete pomocí stavu ovládacího prvku zachovat informace o vlastnosti, které jsou specifické pro ovládací prvek a nelze je vypnout jako vlastnost stavu zobrazení. Další informace o rozdílu mezi stavem ovládacího prvku a stavem zobrazení najdete v tématu Stav ovládacího prvku vs. Příklad stavu zobrazení.

Informace o tom, jak deklarativně povolit nebo zakázat stav zobrazení pro ASP.NET stránku, najdete v tématu @ Page.

Platí pro

Sdílet prostřednictvím