Control.ViewState Свойство

Определение

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

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, содержащего сведения о состоянии представления серверного элемента управления.

Атрибуты

Примеры

В следующем примере демонстрируется 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 Обзор производительности.

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

Применяется к

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