StateBag.Item[String] Propriedade

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

Parâmetros

Valor de Propriedade

O item especificado no StateBag objeto.

Exemplos

O exemplo de código seguinte demonstra uma propriedade que guarda o seu nome e valor como par chave/valor da Control.ViewState propriedade. A ViewState propriedade é uma instância da StateBag classe.

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

Observações

Usar este membro é a forma mais simples de guardar e recuperar valores de estado de visualização para um controlo ou página.

Se um item ainda não estiver armazenado no StateBag objeto quando definir esta propriedade, o seu par chave/valor é adicionado à coleção. Se definir esta propriedade para null antes de o TrackViewState método ser chamado a um item, ela é removida do StateBag objeto. Caso contrário, quando definires esta propriedade para null a chave, a chave é guardada para permitir o acompanhamento do estado de visualização do item.

Ver também

• Add(String, Object)
• Remove(String)
• ViewState
• ASP.NET Recomendações de Gestão Estadual