Control.EnableViewState Vlastnost

Definice

Získává nebo nastavuje hodnotu, která označuje, jestli ovládací prvek serveru zachovává svůj stav zobrazení, a stav zobrazení všech podřízených ovládacích prvků, které obsahuje, pro žádajícího 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); };
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

truePokud serverový ovládací prvek udržuje svůj stav zobrazení; v opačném případě false .true if the server control maintains its view state; otherwise false. Výchozí formát je true.The default is true.

Atributy

Příklady

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

Poznámky

Stav zobrazení umožňuje, aby serverový ovládací prvek udržoval svůj stav napříč požadavky HTTP.View state enables a server control to maintain its state across HTTP requests. Stav zobrazení ovládacího prvku je povolen, pokud jsou splněny všechny následující podmínky:View state for a control is enabled if all of the following conditions are met:

Další informace najdete v tématu ViewStateMode vlastnost.For more information, see the ViewStateMode property.

Stav zobrazení ovládacího prvku serveru je akumulace všech hodnot vlastností.A server control's view state is the accumulation of all its property values. Aby bylo možné zachovat tyto hodnoty napříč požadavky HTTP, ASP.NET používá instanci StateBag třídy pro uložení hodnot vlastností.In order to preserve these values across HTTP requests, ASP.NET uses an instance of the StateBag class to store the property values. Hodnoty jsou poté předány jako proměnná do skrytého pole při zpracování následných žádostí.The values are then passed as a variable to a hidden field when subsequent requests are processed. Další informace o stavu zobrazení naleznete v tématu Přehled stavu zobrazení ASP.NET.For more information about view state, see ASP.NET View State Overview.

Existují situace, kdy je vhodné zakázat stav zobrazení, zejména pro zlepšení výkonu aplikace.There are times when it is appropriate to disable view state, particularly to improve application performance. Například pokud načítáte databázový požadavek do serverového ovládacího prvku, nastavte tuto vlastnost na false .For example, if you are loading a database request into a server control, set this property to false. Pokud to neuděláte, bude čas procesoru při načítání stavu zobrazení do ovládacího prvku serveru, který bude přepsán pouze databázovým dotazem.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. Pokud EnableViewState je false , můžete použít stav ovládacího prvku pro uchovávání informací o vlastnostech, které jsou specifické pro ovládací prvek a nelze ho vypnout podobně jako vlastnost stavu zobrazení.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. Další informace o rozdílu mezi stavem řízení a stavem zobrazení naleznete v tématu stav ovládacích prvků vs. příklad stavu zobrazení.For more information on the difference between control state and view state, see Control State vs. View State Example.

Informace o tom, jak povolit nebo zakázat stav zobrazení deklarativně pro stránku ASP.NET, najdete na @ stránce.For information about how to enable or disable view state declaratively for an ASP.NET page, see @ Page.

Platí pro

Viz také