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.
Assembly: System.Web (in System.Web.dll)
<BrowsableAttribute(False)> _ Protected Overridable ReadOnly Property ViewState As StateBag Get
[BrowsableAttribute(false)] protected virtual StateBag ViewState { get; }
[BrowsableAttribute(false)] protected: virtual property StateBag^ ViewState { StateBag^ get (); }
[<BrowsableAttribute(false)>] abstract ViewState : StateBag [<BrowsableAttribute(false)>] override ViewState : StateBag
Valore proprietà
Tipo: System.Web.UI.StateBagIstanza della classe StateBag che contiene le informazioni sullo stato di visualizzazione del controllo server.
Lo stato di visualizzazione di un controllo server è costituito da tutti i valori delle rispettive proprietà. Per conservare questi valori nelle richieste HTTP, i controlli server ASP.NET utilizzano questa proprietà, che è un'istanza della classe StateBag, per memorizzare i valori della proprietà. I valori sono quindi passati come variabile a un elemento di input HTML nascosto quando vengono elaborate le richieste successive. Per ulteriori informazioni sul salvataggio dello stato di visualizzazione del controllo server, vedere Cenni preliminari sulla gestione dello stato ASP.NET.
Per impostazione predefinita, lo stato di visualizzazione è attivato per tutti i controlli server, ma in alcuni casi è possibile disabilitarlo. Per ulteriori informazioni, vedere la classe Cenni preliminari sulle prestazioni.
Per informazioni sui dizionari e sul loro utilizzo, vedere Insiemi e strutture di dati.
Nell'esempio riportato di seguito viene illustrata l'implementazione di una proprietà Text che memorizza e recupera il proprio valore dalla proprietà ViewState del controllo.
' 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
// 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;
}
}
.NET Framework
Supportato in: 4, 3.5, 3.0, 2.0, 1.1, 1.0Windows 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.