StateBag.Item-Eigenschaft

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

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Default Property Item ( _
    key As String _
) As Object
'Usage
Dim instance As StateBag
Dim key As String
Dim value As Object

value = instance(key)

instance(key) = value

public Object this [
    string key
] { get; set; }

public:
property Object^ default [String^] {
    Object^ get (String^ key);
    void set (String^ key, Object^ value);
}

/** @property */
public Object get_Item (String key)

/** @property */
public void set_Item (String key, Object value)

JScript unterstützt die Verwendung von indizierten Eigenschaften, aber nicht die Deklaration von neuen indizierten Eigenschaften.

Parameter

• key
  Der Schlüssel für das Element.

Eigenschaftenwert

Das angegebene Element im StateBag-Objekt.

Hinweise

Mithilfe dieses Members können Sie Werte des Ansichtszustands für ein Steuerelement oder eine Seite am einfachsten speichern und abrufen.

Wenn ein Element beim Festlegen dieser Eigenschaft noch nicht im StateBag-Objekt gespeichert ist, wird der Auflistung dessen Schlüssel-Wert-Paar hinzugefügt. Wenn Sie diese Eigenschaft vor Aufrufen der TrackViewState-Methode für ein Element auf NULL (Nothing in Visual Basic) festlegen, wird sie aus dem StateBag-Objekt entfernt. Wenn diese Eigenschaft andernfalls auf NULL (Nothing in Visual Basic) festgelegt wird, wird der Schlüssel gespeichert, um das Nachverfolgen des Ansichtszustands des Elements zu ermöglichen.

Beispiel

Im folgenden Beispiel 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 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

private const int defaultFontSize = 3;

// 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.
/** @property 
 */
public String get_Text()
{
    return ((String)(get_ViewState().get_Item("Text")));
} //get_Text

/** @property 
 */
public void set_Text(String value)
{
    get_ViewState().set_Item("Text", value);
} //set_Text

// Add property values to view state with set;
// retrieve them from view state with get.
public function get Text() : String 
{
       return String(ViewState["Text"]);
}

public function set Text(value : String)
{
       ViewState["Text"] = value;
}

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

StateBag-Klasse
StateBag-Member
System.Web.UI-Namespace
Add
Remove
Control.ViewState-Eigenschaft

Weitere Ressourcen

Empfehlungen zur ASP.NET-Zustandsverwaltung