.NET Framework クラス ライブラリ
Control..::.ViewState プロパティ

更新 : 2007 年 11 月

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

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

構文

Visual Basic (宣言)
<BrowsableAttribute(False)> _
Protected Overridable ReadOnly Property ViewState As StateBag
Visual Basic (使用法)
Dim value As StateBag

value = Me.ViewState
C#
[BrowsableAttribute(false)]
protected virtual StateBag ViewState { get; }
Visual C++
[BrowsableAttribute(false)]
protected:
virtual property StateBag^ ViewState {
    StateBag^ get ();
}
J#
/** @property */
/** @attribute BrowsableAttribute(false) */
protected StateBag get_ViewState()
JScript
protected function get ViewState () : StateBag

プロパティ値

型 : System.Web.UI..::.StateBag

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

解説

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

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

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

TopicLocation
方法 : ビューステートから値を読み取る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 Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。

バージョン情報

.NET Framework

サポート対象 : 3.5、3.0、2.0、1.1、1.0
参照

参照

その他の技術情報

タグ :


Page view tracker