Control.ViewState プロパティ

[アーティクル]
06/26/2007

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

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

構文

'宣言
Protected Overridable ReadOnly Property ViewState As StateBag
'使用
Dim value As StateBag

value = Me.ViewState

protected virtual StateBag ViewState { get; }

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

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

protected function get ViewState () : StateBag

適用できません。

プロパティ値

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

解説

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

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

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

トピック	場所
方法 : ビューステートに値を保存する	ASP .NET Web アプリケーションの作成
方法 : ビューステートから値を読み取る	ASP .NET Web アプリケーションの作成

使用例

コントロールの 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 98,Windows Server 2000 SP4,Windows CE,Windows Millennium Edition,Windows Mobile for Pocket PC,Windows Mobile for Smartphone,Windows Server 2003,Windows XP Media Center Edition,Windows XP Professional x64 Edition,Windows XP SP2,Windows XP Starter Edition

Microsoft .NET Framework 3.0 は Windows Vista,Microsoft Windows XP SP2,および Windows Server 2003 SP1 でサポートされています。

次の方法で共有

Control.ViewState プロパティ

構文

プロパティ値

解説

使用例

プラットフォーム

バージョン情報

.NET Framework

参照

関連項目

その他の技術情報

その他のリソース