Control.ViewState-Eigenschaft
Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können.
Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)
Syntax
'Declaration
Protected Overridable ReadOnly Property ViewState As StateBag
'Usage
Dim value As StateBag
value = Me.ViewState
protected virtual StateBag ViewState { get; }
protected:
virtual property StateBag^ ViewState {
StateBag^ get ();
}
/** @property */
protected StateBag get_ViewState ()
protected function get ViewState () : StateBag
Eigenschaftenwert
Eine Instanz der StateBag-Klasse, in der Informationen zum Ansichtszustand des Serversteuerelements enthalten sind.
Hinweise
Der Ansichtszustand eines Serversteuerelements besteht aus der Ansammlung aller zugehörigen Eigenschaftenwerte. Damit diese Werte über HTTP-Anforderungen hinweg erhalten bleiben, verwenden ASP.NET-Serversteuerelemente zum Speichern der Eigenschaftenwerte diese Eigenschaft, die eine Instanz der StateBag-Klasse ist. Die Werte werden dann bei der Verarbeitung nachfolgender Anforderungen als Variable an ein ausgeblendetes HTML-Eingabeelement übergeben. Weitere Informationen zum Speichern des Ansichtszustands von Serversteuerelementen finden Sie unter ASP.NET-Zustandsverwaltung.
Der Ansichtszustand wird standardmäßig für alle Serversteuerelemente aktiviert. In bestimmten Fällen kann es jedoch ratsam sein, ihn zu deaktivieren. Weitere Informationen finden Sie unter Entwickeln von leistungsfähigen ASP.NET-Anwendungen.
Weitere Informationen zu Wörterbüchern und ihrer Verwendung finden Sie unter Auflistungen und Datenstrukturen.
| Thema | Position |
|---|---|
| Gewusst wie: Speichern von Werten im Ansichtszustand | Erstellen von ASP.NET-Webanwendungen |
| Gewusst wie: Lesen von Werten aus dem Ansichtszustand | Erstellen von ASP.NET-Webanwendungen |
Beispiel
Im folgenden Beispiel wird die Implementierung einer Text-Eigenschaft veranschaulicht, die ihren Wert aus der ViewState-Eigenschaft des zugehörigen Steuerelements abruft und speichert.
' 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
private const int defaultFontSize = 3;
// 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.
/** @property
*/
public String get_Text()
{
return ((String)(get_ViewState().get_Item("Text")));
} //get_Text
/** @property
*/
public void set_Text(String value)
{
get_ViewState().set_Item("Text", value);
} //set_Text
// Add property values to view state with set;
// retrieve them from view state with get.
public function get Text() : String
{
return String(ViewState["Text"]);
}
public function set Text(value : String)
{
ViewState["Text"] = value;
}
Plattformen
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
Control-Klasse
Control-Member
System.Web.UI-Namespace
StateBag