Ler em inglês

Compartilhar via


Control.ViewState Propriedade

Definição

Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página.

[System.ComponentModel.Browsable(false)]
protected virtual System.Web.UI.StateBag ViewState { get; }

Valor da propriedade

Uma instância da classe StateBag que contém informações de estado de exibição do controle de servidor.

Atributos

Exemplos

O exemplo a seguir demonstra a implementação de uma Text propriedade que armazena e recupera seu valor da propriedade de ViewState seu controle.

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

Comentários

O estado de exibição de um controle de servidor é o acúmulo de todos os seus valores de propriedade. Para preservar esses valores entre solicitações HTTP, ASP.NET controles de servidor usam essa propriedade, que é uma instância da StateBag classe , para armazenar os valores da propriedade. Os valores são então passados como uma variável para um elemento de entrada oculto HTML quando solicitações subsequentes são processadas. Para obter mais informações sobre como salvar o estado de exibição de controle do servidor, consulte Visão geral do Gerenciamento de Estado do ASP.NET.

O estado de exibição está habilitado para todos os controles de servidor por padrão, mas há circunstâncias em que você deseja desabilitá-lo. Para obter mais informações, consulte Visão geral do desempenho do ASP.NET.

Para obter informações sobre dicionários e como usá-los, consulte Coleções e estruturas de dados.

Aplica-se a

Produto Versões
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Confira também