Control.ViewState 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 un dizionario di informazioni sullo stato che permette di salvare e ripristinare lo stato di visualizzazione di un controllo server attraverso più richieste per la stessa pagina.

protected:
 virtual property System::Web::UI::StateBag ^ ViewState { System::Web::UI::StateBag ^ get(); };

[System.ComponentModel.Browsable(false)]
protected virtual System.Web.UI.StateBag ViewState { get; }

[<System.ComponentModel.Browsable(false)>]
member this.ViewState : System.Web.UI.StateBag

Protected Overridable ReadOnly Property ViewState As StateBag

Valore della proprietà

StateBag

Istanza della classe StateBag che contiene le informazioni sullo stato di visualizzazione del controllo server.

Attributi: BrowsableAttribute

Esempio

Nell'esempio seguente viene illustrata l'implementazione di una Text proprietà che archivia e recupera il relativo valore dalla proprietà del ViewState controllo.

// Add property values to view state with set;
// retrieve them from view state with get.
public String Text
{
    get 
    { 
        object o = ViewState["Text"]; 
        return (o == null)? String.Empty : (string)o;
    }

    set
    {
        ViewState["Text"] = value;
    }
}

' Add property values to view state with set; 
' retrieve them from view state with get.
Public Property [Text]() As String
    Get
        Dim o As Object = ViewState("Text")
        If (IsNothing(o)) Then
            Return String.Empty
        Else
            Return CStr(o)
        End If
    End Get
    Set(ByVal value As String)
        ViewState("Text") = value
    End Set
End Property

Commenti

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 i controlli server usano questa proprietà, ovvero un'istanza StateBag della classe, per archiviare i valori delle proprietà. I valori vengono quindi passati come variabile a un elemento di input nascosto HTML quando vengono elaborate le richieste successive. Per altre informazioni sul salvataggio dello stato di visualizzazione del controllo server, vedere Panoramica sulla gestione dello stato ASP.NET.

Lo stato di visualizzazione è abilitato per tutti i controlli server per impostazione predefinita, ma esistono circostanze in cui si vuole disabilitarlo. Per altre informazioni, vedere Panoramica delle prestazioni ASP.NET.

Per informazioni sui dizionari e su come usarli, vedere Raccolte e strutture dati.

Si applica a

Condividi tramite