Parameter.ViewState プロパティ

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

Parameter.ViewState プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

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

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

Visual Basic (宣言)

Protected ReadOnly Property
 ViewState As StateBag

Visual Basic (使用法)

Dim value As StateBag

value = Me.ViewState

C#

protected StateBag ViewState { get; }

C++

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

J#

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

JScript

protected function get ViewState
 () : StateBag

プロパティ値
Parameter オブジェクトのビューステート情報を格納している StateBag のインスタンス。

解説

パラメータのビューステートは、そのすべてのプロパティ値の累積によって表されます。複数の HTTP 要求にわたってこれらの値を保存するために、ASP.NET サーバー コントロールは StateBag クラスのインスタンスであるこのプロパティを使用して、プロパティ値を格納します。これらの値は、後続の要求が処理されるときに、HTML hidden 入力要素に変数として渡されます。既定では、ビューステートはすべてのサーバー コントロールで有効です (「高パフォーマンス ASP.NET アプリケーションの開発」を参照)。

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

使用例

ビューステート オブジェクトを使用して、Parameter クラスを拡張したクラスにパラメータ オブジェクトの状態を格納する方法を次のコード例に示します。このコード例は Parameter クラスの概要で取り上げているコード例の一部分です。

Visual Basic

' The DataValue can be any arbitrary object and is stored in ViewState.
Public Property DataValue() As
 Object
   Get
      Return ViewState("Value")
   End Get
   Set
      ViewState("Value") = value
   End Set
End Property

C#

// The DataValue can be any arbitrary object and is stored in ViewState.
public object DataValue {
  get {
    return ViewState["Value"];
  }
  set {
    ViewState["Value"] = value;
  }
}

J#

// The DataValue can be any arbitrary object and is stored in ViewState.
/** @property 
 */
public Object get_DataValue()
{
    return get_ViewState().get_Item("Value");
} //get_DataValue


/** @property 
 */
public void set_DataValue(Object value)
{
    get_ViewState().set_Item("Value", value);
} //set_DataValue

プラットフォーム

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

参照

関連項目
Parameter クラス
Parameter メンバ
System.Web.UI.WebControls 名前空間
Parameter.IsTrackingViewState プロパティ
LoadViewState
SaveViewState
TrackViewState