Control.EnableViewState Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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: ThemeableAttribute

Esempio

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

La EnableViewState proprietà della pagina è impostata su true.
La EnableViewState proprietà per il controllo è impostata su true.
La ViewStateMode proprietà per il controllo è impostata su Enabled o eredita l'impostazione Enabled .

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 le richieste HTTP, ASP.NET usa un'istanza della StateBag classe per archiviare i valori della 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 dello stato di visualizzazione ASP.NET.

In alcuni casi è opportuno 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 del processore verrà sprecato durante il caricamento dello stato di visualizzazione nel controllo server che verrà sostituito solo dalla query del database. Se EnableViewState è false, è possibile utilizzare lo stato del controllo per rendere persistenti le informazioni sulle proprietà specifiche di un controllo e non possono essere disattivate come la proprietà dello stato di visualizzazione. Per altre informazioni sulla differenza tra lo stato del controllo e lo stato di visualizzazione, vedere Control State vs. View State Example.For more information on the difference between control state and view state, see Control State vs. View State Example.

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

Si applica a

Condividi tramite