Control.ViewState Eigenschaft

Definition

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.

protected:
 virtual property System::Web::UI::StateBag ^ ViewState { System::Web::UI::StateBag ^ get(); };
[System.ComponentModel.Browsable(false)]
protected virtual System.Web.UI.StateBag ViewState { get; }
[<System.ComponentModel.Browsable(false)>]
member this.ViewState : System.Web.UI.StateBag
Protected Overridable ReadOnly Property ViewState As StateBag

Eigenschaftswert

StateBag

Eine Instanz der StateBag-Klasse, in der Informationen zum Ansichtszustand des Serversteuerelements enthalten sind.

Attribute

Beispiele

Im folgenden Beispiel wird die Implementierung einer Text Eigenschaft veranschaulicht, die den Wert aus der Eigenschaft des Steuerelements ViewState speichert und abgerufen.

// 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.
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

Hinweise

Der Ansichtszustand eines Serversteuerelements ist die Kumulation aller Eigenschaftenwerte. Um diese Werte in HTTP-Anforderungen beizubehalten, verwenden ASP.NET Serversteuerelemente diese Eigenschaft, die eine Instanz der StateBag Klasse ist, um die Eigenschaftenwerte zu speichern. Die Werte werden dann als Variable an ein HTML-ausgeblendetes Eingabeelement übergeben, wenn nachfolgende Anforderungen verarbeitet werden. Weitere Informationen zum Speichern des Status der Serversteuerelementansicht finden Sie unter ASP.NET Übersicht über die Statusverwaltung.

Der Ansichtszustand ist standardmäßig für alle Serversteuerelemente aktiviert, aber es gibt Umstände, in denen Sie sie deaktivieren möchten. Weitere Informationen finden Sie unter ASP.NET Leistungsübersicht.

Informationen zu Wörterbüchern und deren Verwendung finden Sie unter Sammlungen und Datenstrukturen.

Gilt für:

Siehe auch