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 状态管理概述