Control.EnableViewState Vlastnost

Definice

Získá nebo nastaví hodnotu označ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, do žá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

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

Atributy

Příklady

Následující příklad nastaví vlastnost na EnableViewStatefalse.

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 ovládacímu prvku serveru 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:

Další informace najdete ve ViewStateMode vlastnosti .

Stav zobrazení serverového ovládacího prvku je akumulace všech jeho hodnot vlastností. Aby bylo možné zachovat tyto hodnoty napříč požadavky HTTP, používá ASP.NET 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í.

Existují časy, kdy je vhodné zakázat stav zobrazení, zejména kvůli zvýšení výkonu aplikace. Pokud například načítáte požadavek na databázi do serverového ovládacího prvku, nastavte tuto vlastnost na false. Pokud to neuděláte, čas procesoru bude 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 stav ovládacího prvku použít k zachování informací 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, naleznete v tématu @ Page.

Platí pro

Viz také