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 パフォーマンスの概要」を参照してください。
ディクショナリとその使用方法については、「 コレクションとデータ構造」を参照してください。
適用対象
こちらもご覧ください
.NET