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 國家管理概述