更新 : 2007 年 11 月
同一のページに対する複数の要求にわたって、サーバー コントロールのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。
名前空間 :
System.Web.UI アセンブリ :
System.Web (System.Web.dll 内)
<BrowsableAttribute(False)> _
Protected Overridable ReadOnly Property ViewState As StateBag
Dim value As StateBag
value = Me.ViewState
[BrowsableAttribute(false)]
protected virtual StateBag ViewState { get; }
[BrowsableAttribute(false)]
protected:
virtual property StateBag^ ViewState {
StateBag^ get ();
}
/** @property */
/** @attribute BrowsableAttribute(false) */
protected StateBag get_ViewState()
protected function get ViewState () : StateBag
サーバー コントロールのビューステートは、そのサーバー コントロールのプロパティ値をすべて累積した値によって表されます。複数の HTTP 要求にわたってこれらの値を保存するために、ASP.NET サーバー コントロールは StateBag クラスのインスタンスであるこのプロパティを使用して、プロパティ値を格納します。これらの値は、後続の要求が処理されるときに、変数として HTML 非表示入力要素に渡されます。サーバー コントロールのビューステートの保存の詳細については、「ASP.NET の状態管理の概要」を参照してください。
ビューステートは、既定ではすべてのサーバー コントロールで有効にされていますが、無効にする必要がある場合もあります。詳細については、「パフォーマンスの概要」を参照してください。
ディクショナリとその使用方法の詳細については、「コレクションとデータ構造体」を参照してください。
コントロールの ViewState プロパティから値を取得し、格納する Text プロパティを実装する例を次に示します。
' 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
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;
}
}
// 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
// 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
参照
その他の技術情報