Control.EnableViewState Vlastnost

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

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, do žádajícího klienta.

public:
 virtual property bool EnableViewState { bool get(); void set(bool value); };

[System.Web.UI.Themeable(false)]
public virtual bool EnableViewState { 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 serverový ovládací prvek udržuje svůj stav zobrazení; jinak false. Výchozí hodnota 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 řízení serveru udržovat svůj stav napříč požadavky HTTP. Stav zobrazení ovládacího prvku je povolen, pokud jsou splněny všechny následující podmínky:

• Vlastnost EnableViewState stránky je nastavena na truehodnotu .

• Vlastnost EnableViewState ovládacího prvku je nastavena na truehodnotu .

• Vlastnost ViewStateMode ovládacího prvku je nastavena Enabled nebo dědí Enabled nastavení.

Další informace najdete ve vlastnosti ViewStateMode.

Stav zobrazení ovládacího prvku serveru 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ředávají 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í.

V době, kdy je vhodné zakázat stav zobrazení, zejména kvůli zlepšení výkonu aplikace. Pokud například načítáte požadavek databáze do ovládacího prvku serveru, nastavte tuto vlastnost na falsehodnotu . Pokud to neuděláte, čas procesoru bude ztrácet stav zobrazení načítání do ovládacího prvku serveru, který se přepíše pouze databázovým dotazem. Pokud EnableViewState ano 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 je 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 zobrazení stavu.

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

Viz také

• ViewStateMode
• ViewState
• LoadViewState(Object)
• SaveViewState()
• IsViewStateEnabled
• Úvod do životního cyklu stránky ASP.NET
• Přehled správy stavu ASP.NET
• Stav ovládacího prvku vs. Příklad zobrazení stavu