Control.ViewState Свойство

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.dll

Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления серверного элемента управления при нескольких запросах одной и той же страницы.

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

Значение свойства

StateBag

Экземпляр класса StateBag, содержащего сведения о состоянии представления серверного элемента управления.

Атрибуты

BrowsableAttribute

Примеры

В следующем примере показано, как реализовать Text свойство, которое хранит и извлекает его значение из свойства элемента управления 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

Комментарии

Состояние представления серверного элемента управления — это накопление всех его значений свойств. Чтобы сохранить эти значения в HTTP-запросах, ASP.NET серверные элементы управления используют это свойство, которое является экземпляром класса для хранения значений StateBag свойств. Затем значения передаются в виде переменной в скрытый входной элемент HTML при обработке последующих запросов. Дополнительные сведения о сохранении состояния представления управления сервером см. в разделе ASP.NET Обзор управления состоянием.

Состояние представления включено для всех серверных элементов управления по умолчанию, но есть обстоятельства, в которых вы хотите отключить его. Дополнительные сведения см. в разделе ASP.NET Обзор производительности.

Сведения о словарях и их использовании см. в разделах "Коллекции и структуры данных".

См. также раздел

• StateBag
• Общие сведения об управлении состоянием ASP.NET