Control.EnableViewState Proprietà

Definizione

Ottiene o imposta un valore che indica se lo stato di visualizzazione del controllo server deve essere persistente e lo stato di visualizzazione dei controlli figlio contenuti, per il client richiedente.

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

Valore della proprietà

Boolean

true se il controllo server mantiene lo stato di visualizzazione. In caso contrario, false. Il valore predefinito è true.

Attributi

Esempio

Nell'esempio seguente viene impostata la EnableViewState proprietà su 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

Commenti

Lo stato di visualizzazione consente a un controllo server di mantenere lo stato tra le richieste HTTP. Lo stato di visualizzazione per un controllo è abilitato se vengono soddisfatte tutte le condizioni seguenti:

Per altre informazioni, vedere la proprietà ViewStateMode.

Lo stato di visualizzazione di un controllo server è l'accumulo di tutti i relativi valori di proprietà. Per mantenere questi valori tra richieste HTTP, ASP.NET usa un'istanza della StateBag classe per archiviare i valori delle proprietà. I valori vengono quindi passati come variabile a un campo nascosto quando vengono elaborate le richieste successive. Per altre informazioni sullo stato di visualizzazione, vedere panoramica sullo stato di visualizzazione ASP.NET.

Esistono momenti in cui è necessario disabilitare lo stato di visualizzazione, in particolare per migliorare le prestazioni dell'applicazione. Ad esempio, se si carica una richiesta di database in un controllo server, impostare questa proprietà su false. In caso contrario, il tempo di caricamento della visualizzazione verrà sprecato nel controllo server che verrà sottoposto a override solo dalla query del database. Se EnableViewState è false, è possibile usare lo stato del controllo per rendere persistenti le informazioni sulla proprietà specifiche di un controllo e non può essere disattivato come la proprietà dello stato di visualizzazione. Per altre informazioni sulla differenza tra lo stato del controllo e lo stato di visualizzazione, vedere Esempio di stato di controllo e di visualizzazione.

Per informazioni su come abilitare o disabilitare lo stato di visualizzazione in modo dichiarativo per una pagina ASP.NET, vedere @ Pagina.

Si applica a

Vedi anche