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 狀態管理概觀