Freigeben über


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

Weitere Ressourcen

ASP.NET-Zustandsverwaltung