Control.ViewState プロパティ

.NET Framework クラス ライブラリ リファレンス

Control.ViewState プロパティ

同一のページに対する複数の要求にわたって、サーバー コントロールのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Protected Overridable ReadOnly
 Property ViewState As StateBag

Visual Basic (使用法)

Dim value As StateBag

value = Me.ViewState

C#

protected virtual StateBag ViewState { get;
 }

C++

protected:
virtual property StateBag^ ViewState {
    StateBag^ get ();
}

J#

/** @property */
protected StateBag get_ViewState ()

JScript

protected function get ViewState
 () : StateBag

プロパティ値
サーバー コントロールのビューステートの情報を格納している StateBag クラスのインスタンス。

解説

サーバー コントロールのビューステートは、そのサーバー コントロールのプロパティ値をすべて累積した値によって表されます。複数の HTTP 要求にわたってこれらの値を保存するために、ASP.NET サーバー コントロールは StateBag クラスのインスタンスであるこのプロパティを使用して、プロパティ値を格納します。これらの値は、後続の要求が処理されるときに、変数として HTML 非表示入力要素に渡されます。サーバー コントロールのビューステートの保存の詳細については、「ASP.NET の状態管理」を参照してください。

ビューステートは、既定ではすべてのサーバー コントロールで有効にされていますが、無効にする必要がある場合もあります。詳細については、「高パフォーマンス ASP.NET アプリケーションの開発」を参照してください。

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

Topic	Location
方法 : ビューステートから値を読み取る	ASP .NET Web アプリケーションの作成
方法 : ビューステートに値を保存する	ASP .NET Web アプリケーションの作成

使用例

コントロールの ViewState プロパティから値を取得し、格納する Text プロパティを実装する例を次に示します。

Visual Basic

' 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

C#

private const int defaultFontSize
 = 3;

// 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;
    }
}

J#

// Add property values to view state with set;
// retrieve them from view state with get.
/** @property 
 */
public String get_Text()
{
    return ((String)(get_ViewState().get_Item("Text")));
} //get_Text

/** @property 
 */
public void set_Text(String value)
{
    get_ViewState().set_Item("Text", value);
} //set_Text

JScript

// Add property values to view state with set;
// retrieve them from view state with get.
public function get Text()
 : String 
{
       return String(ViewState["Text"]);
}

public function set Text(value
 : String)
{
       ViewState["Text"] = value;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Control クラス
Control メンバ
System.Web.UI 名前空間
StateBag
その他の技術情報
ASP.NET の状態管理