StateBag.Item[String] Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Ruft den Wert eines im StateBag-Objekt gespeicherten Elements ab oder legt diesen fest.

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

Object

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 Members ist die einfachste Möglichkeit, Ansichtszustandswerte für ein Steuerelement oder eine Seite zu speichern und abzurufen.

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

Gilt für:

Weitere Informationen