Freigeben über


StateBag.Item[String] Eigenschaft

Definition

Dient zum Abrufen oder Festlegen des Werts eines Elements, das StateBag im Objekt gespeichert ist.

public:
 property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ key); void set(System::String ^ key, System::Object ^ value); };
public object this[string key] { get; set; }
member this.Item(string) : obj with get, set
Default Public Property Item(key As String) As Object

Parameter

key
String

Der Schlüssel für das Element.

Eigenschaftswert

Das angegebene Element im StateBag Objekt.

Beispiele

Im folgenden Codebeispiel wird eine Eigenschaft veranschaulicht, die ihren Namen und Wert als Schlüssel-Wert-Paar in der Control.ViewState Eigenschaft speichert. Die ViewState Eigenschaft ist eine Instanz der StateBag Klasse.

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

Die Verwendung dieses Elements ist die einfachste Möglichkeit zum Speichern und Abrufen von Ansichtszustandswerten für ein Steuerelement oder eine Seite.

Wenn ein Element noch nicht im StateBag Objekt gespeichert ist, wenn Sie diese Eigenschaft festlegen, wird das Schlüssel-Wert-Paar der Auflistung hinzugefügt. Wenn Sie diese Eigenschaft festlegen, null bevor die TrackViewState Methode für ein Element aufgerufen wird, wird sie aus dem StateBag Objekt entfernt. Andernfalls wird diese Eigenschaft auf null den Schlüssel gespeichert, um die Nachverfolgung des Ansichtszustands des Elements zu ermöglichen.

Gilt für:

Weitere Informationen