Control.ViewState プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
同一のページに対する複数の要求にわたって、サーバー コントロールのビューステートを保存し、復元できるようにする状態情報のディクショナリを取得します。
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 状態管理の概要」を参照してください。
既定では、すべてのサーバー コントロールに対してビューステートが有効になっていますが、無効にしたい状況があります。 詳細については、「 ASP.NET パフォーマンスの概要」を参照してください。
ディクショナリとその使用方法については、「 コレクションとデータ構造」を参照してください。