Proprietà Control.EnableViewState (System.Web.UI)

Cambia visualizzazione:
ScriptFree
Riferimento a .NET Framework
Proprietà Control.EnableViewState
Il presente articolo è stato tradotto manualmente. Per visualizzare questa pagina e contemporaneamente visualizzarne il contenuto in lingua inglese, passare alla visualizzazione semplificata.

Ottiene o imposta un valore che indica se il controllo server conserva il proprio stato di visualizzazione e lo stato di visualizzazione dei controlli figlio in esso contenuti per il client richiedente.

Spazio dei nomi:  System.Web.UI
Assembly:  System.Web (in System.Web.dll)
Sintassi

Visual Basic
<ThemeableAttribute(False)> _
Public Overridable Property EnableViewState As Boolean
	Get
	Set
C#
[ThemeableAttribute(false)]
public virtual bool EnableViewState { get; set; }
Visual C++
[ThemeableAttribute(false)]
public:
virtual property bool EnableViewState {
	bool get ();
	void set (bool value);
}
F#
[<ThemeableAttribute(false)>]
abstract EnableViewState : bool with get, set
[<ThemeableAttribute(false)>]
override EnableViewState : bool with get, set

Valore proprietà

Tipo: System.Boolean
true se il controllo server conserva lo stato di visualizzazione; in caso contrario, false. Il valore predefinito è true.
Note

Lo stato di visualizzazione abilita la conservazione dello stato da parte di un controllo server durante le richieste HTTP. Lo stato di visualizzazione per un controllo è abilitato se tutte le condizioni seguenti sono soddisfatte:

  • La proprietà EnableViewState per la pagina è impostata su true.

  • La proprietà EnableViewState per il controllo è impostata su true.

  • La proprietà ViewStateMode per il controllo viene impostata su Enabled o eredita l'impostazione del campo Enabled.

Per ulteriori informazioni, vedere la proprietà ViewStateMode.

Lo stato di visualizzazione di un controllo server è costituito da tutti i valori delle rispettive proprietà. Per conservare questi valori nelle richieste HTTP, ASP.NET utilizza un'istanza della classe StateBag per memorizzare i valori delle proprietà. I valori sono quindi passati come variabili a un campo nascosto quando vengono elaborate le richieste successive. Per ulteriori informazioni sullo stato di visualizzazione, vedere Cenni preliminari sullo stato di visualizzazione ASP.NET.

In alcuni casi è necessario disabilitare lo stato di visualizzazione, in particolare per migliorare le prestazioni dell'applicazione. Ad esempio, per caricare una richiesta di database in un controllo server, impostare questa proprietà su false. In caso contrario, verrà sprecato tempo per caricare lo stato di visualizzazione nel controllo server, il quale sarà soltanto sottoposto a override dalla query al database. Se EnableViewState è false, è possibile utilizzare lo stato del controllo per rendere persistenti informazioni sulle proprietà specifiche di un controllo che non è possibile disattivare come la proprietà dello stato di visualizzazione. Per ulteriori informazioni sulla differenza tra lo stato del controllo e lo stato di visualizzazione, vedereEsempio di confronto tra stato del controllo e stato di visualizzazione.

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

Esempi

Nell'esempio riportato di seguito la proprietà EnableViewState viene impostata su false.

Visual Basic

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


C#

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;

}


Informazioni sulla versione

.NET Framework

Supportato in: 4, 3.5, 3.0, 2.0, 1.1, 1.0
Piattaforme

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Vedere anche

Riferimenti

Altre risorse