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 State Management Overview」を参照してください。

既定では、すべてのサーバー コントロールに対してビューステートが有効になっていますが、無効にしたい状況があります。 詳細については、「 ASP.NET パフォーマンスの概要」を参照してください。

ディクショナリとその使用方法については、「 コレクションとデータ構造」を参照してください。

適用対象

こちらもご覧ください