Control.ViewState Propriedade

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

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.

protected:
 virtual property System::Web::UI::StateBag ^ ViewState { System::Web::UI::StateBag ^ get(); };

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

[<System.ComponentModel.Browsable(false)>]
member this.ViewState : System.Web.UI.StateBag

Protected Overridable ReadOnly Property ViewState As StateBag

Valor da propriedade

StateBag

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

Atributos

BrowsableAttribute

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

' 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

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. Em seguida, os valores sã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 ASP.NET Visão geral do Gerenciamento de Estado.

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 ASP.NET Visão geral do desempenho.

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

Confira também

• StateBag
• Visão geral do Gerenciamento de Estado ASP.NET