.NET Framework-Klassenbibliothek
Control..::.ViewState-Eigenschaft

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)
Syntax

Visual Basic (Deklaration)
<BrowsableAttribute(False)> _
Protected Overridable ReadOnly Property ViewState As StateBag
Visual Basic (Verwendung)
Dim value As StateBag

value = Me.ViewState
C#
[BrowsableAttribute(false)]
protected virtual StateBag ViewState { get; }
VisualC++
[BrowsableAttribute(false)]
protected:
virtual property StateBag^ ViewState {
    StateBag^ get ();
}
J#
/** @property */
/** @attribute BrowsableAttribute(false) */
protected StateBag get_ViewState()
Jscript
protected function get ViewState () : StateBag

Eigenschaftenwert

Typ: System.Web.UI..::.StateBag
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 Ü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.

TopicLocation
Gewusst wie: Lesen von Werten aus dem AnsichtszustandErstellen von ASP.NET-Webanwendungen
Gewusst wie: Speichern von Werten im AnsichtszustandErstellen von ASP.NET-Webanwendungen
Beispiele

Im folgenden Beispiel wird die Implementierung einer Text-Eigenschaft veranschaulicht, die ihren Wert aus der ViewState-Eigenschaft des zugehörigen Steuerelements abruft und speichert.

Visual Basic
' 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

C#
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;
    }
}

J#
// 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
Jscript
// 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 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.
Versionsinformationen

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0, 1.1, 1.0
Siehe auch

Referenz

Weitere Ressourcen

Tags :


Page view tracker