Control.ViewState Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: BrowsableAttribute

Beispiele

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

// 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 Akkumulation aller Eigenschaftenwerte. Um diese Werte über HTTP-Anforderungen hinweg beizubehalten, verwenden ASP.NET Serversteuerelemente diese Eigenschaft, die eine Instanz der StateBag -Klasse ist, um die Eigenschaftswerte zu speichern. Die Werte werden dann als Variable an ein ausgeblendetes HTML-Eingabeelement übergeben, wenn nachfolgende Anforderungen verarbeitet werden. Weitere Informationen zum Speichern des Zustands der Serversteuerelementansicht finden Sie unter ASP.NET Statusverwaltung– Übersicht.

Der Ansichtsstatus ist standardmäßig für alle Serversteuerelemente aktiviert, aber es gibt Umstände, unter denen Sie ihn 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:

Produkt	Versionen
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Freigeben über