Udostępnij za pośrednictwem

StateBag.Item[String] Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI
Zestaw:
System.Web.dll

Pobiera lub ustawia wartość elementu przechowywanego StateBag w obiekcie.

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

Parametry

key
String

Klucz elementu.

Wartość właściwości

Object

Określony element w StateBag obiekcie.

Przykłady

W poniższym przykładzie kodu pokazano właściwość, która zapisuje jego nazwę i wartość jako parę klucz/wartość we Control.ViewState właściwości. Właściwość ViewState jest wystąpieniem StateBag klasy .

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

Uwagi

Użycie tego elementu członkowskiego jest najprostszym sposobem zapisywania i pobierania wartości stanu widoku dla kontrolki lub strony.

Jeśli element nie jest jeszcze przechowywany w StateBag obiekcie podczas ustawiania tej właściwości, jego para klucz/wartość zostanie dodana do kolekcji. Jeśli ustawisz tę właściwość na null wartość przed TrackViewState wywołaniem metody w elemencie, zostanie ona usunięta StateBag z obiektu. W przeciwnym razie po ustawieniu tej właściwości null na klucz jest zapisywany w celu umożliwienia śledzenia stanu widoku elementu.

Dotyczy

Zobacz też