StateBag.Item[String] Eigenschaft
Definition
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.
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.