Compartilhar via


StateBag.Item[String] Propriedade

Definição

Obtém ou define o valor de um item armazenado no objeto StateBag.

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

key
String

A chave para o item.

Valor da propriedade

O item especificado no StateBag objeto .

Exemplos

O exemplo de código a seguir demonstra uma propriedade que salva seu nome e valor como um par chave/valor na 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

Comentários

Usar esse membro é a maneira mais simples de salvar e recuperar valores de estado de exibição para um controle ou uma página.

Se um item ainda não estiver armazenado no StateBag objeto quando você definir essa propriedade, seu par chave/valor será adicionado à coleção. Se você definir essa propriedade como null antes que o TrackViewState método seja chamado em um item, ela será removida do StateBag objeto . Caso contrário, quando você define essa propriedade como null a chave é salva para permitir o acompanhamento do estado de exibição do item.

Aplica-se a

Confira também