Control.ViewState Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI
Zestaw:
System.Web.dll

Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu widoku kontrolki serwera w wielu żądaniach dla tej samej strony.

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

Wartość właściwości

StateBag

Wystąpienie StateBag klasy zawierającej informacje o stanie widoku kontrolki serwera.

Atrybuty
BrowsableAttribute

Przykłady

W poniższym przykładzie pokazano implementację Text właściwości, która przechowuje i pobiera jej wartość z właściwości kontrolki ViewState .

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

Uwagi

Stan widoku kontrolki serwera to akumulacja wszystkich jego wartości właściwości. Aby zachować te wartości w żądaniach HTTP, ASP.NET kontrolki serwera używają tej właściwości, która jest wystąpieniem StateBag klasy, do przechowywania wartości właściwości. Wartości są następnie przekazywane jako zmienna do ukrytego elementu wejściowego HTML po przetworzeniu kolejnych żądań. Aby uzyskać więcej informacji na temat zapisywania stanu widoku kontroli serwera, zobacz ASP.NET State Management Overview (Omówienie zarządzania stanem ASP.NET).

Stan widoku jest domyślnie włączony dla wszystkich kontrolek serwera, ale istnieją okoliczności, w których chcesz ją wyłączyć. Aby uzyskać więcej informacji, zobacz omówienie wydajności ASP.NET.

Aby uzyskać informacje o słownikach i sposobie ich używania, zobacz Kolekcje i struktury danych.

Dotyczy

Zobacz też