Aktualisiert: November 2007
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)
Visual Basic (Deklaration)
<BrowsableAttribute(False)> _
Protected Overridable ReadOnly Property ViewState As StateBag
Visual Basic (Verwendung)
Dim value As StateBag
value = Me.ViewState
[BrowsableAttribute(false)]
protected virtual StateBag ViewState { get; }
[BrowsableAttribute(false)]
protected:
virtual property StateBag^ ViewState {
StateBag^ get ();
}
/** @property */
/** @attribute BrowsableAttribute(false) */
protected StateBag get_ViewState()
protected function get ViewState () : StateBag
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 Übersicht über die 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 Übersicht über die Leistung .
Weitere Informationen zu Wörterbüchern und ihrer Verwendung finden Sie unter Auflistungen und Datenstrukturen.
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;
}
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
.NET Framework
Unterstützt in: 3.5, 3.0, 2.0, 1.1, 1.0
Referenz
Weitere Ressourcen