Control.ViewState Propriedade

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 de Propriedade

Uma instância da StateBag classe que contém a informação de estado de vista do controlo do servidor.

Atributos

BrowsableAttribute

Exemplos

O exemplo seguinte demonstra a implementação de uma Text propriedade que armazena e recupera o seu valor a partir da propriedade do ViewState seu controlo.

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

O estado de vista de um controlo de servidor é a acumulação de todos os valores das suas propriedades. Para preservar estes valores entre pedidos HTTP, ASP.NET controlos do servidor utilizam esta propriedade, que é uma instância da classe StateBag, para armazenar os valores da propriedade. Os valores são então passados como variável para um elemento de entrada HTML oculto quando os pedidos subsequentes são processados. Para mais informações sobre como guardar o estado da vista de controlo do servidor, consulte ASP.NET Visão Geral da Gestão de Estado.

O estado de visualização está ativado por defeito para todos os controlos do servidor, mas há circunstâncias em que vais querer desativá-lo. Para mais informações, consulte ASP.NET Performance Overview.

Para informações sobre dicionários e como os utilizar, consulte Coleções e Estruturas de Dados.

Ver também

• StateBag
• ASP.NET Visão Geral da Gestão do Estado