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

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 效能概觀

如需字典及其使用方式的相關資訊,請參閱 集合和資料結構

適用於

另請參閱