Parameter.SaveViewState メソッド

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

Parameter.SaveViewState メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

ページがサーバーにポストバックされた時間以降に発生した、Parameter オブジェクトのビューステートへの変更を保存します。

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

Visual Basic (宣言)

Protected Overridable Function
 SaveViewState As Object

Visual Basic (使用法)

Dim returnValue As Object

returnValue = Me.SaveViewState

C#

protected virtual Object SaveViewState ()

C++

protected:
virtual Object^ SaveViewState ()

J#

protected Object SaveViewState ()

JScript

protected function SaveViewState () : Object

戻り値
Parameter のビューステートへの変更を格納する Object。オブジェクトに関連付けられているビューステートがない場合、メソッドは null 参照 (Visual Basic では Nothing) を返します。

解説

このメソッドは、主にコントロールの開発者によって使用されます。

ビューステートは、サーバー コントロールのプロパティ値の累積によって表されます。これらの値は、StateBag クラスのインスタンスである、サーバー コントロールの ViewState プロパティに自動的に配置されます。このプロパティの値は、この後、サーバー コントロールの有効期間が保存状態の段階を終えても、文字列オブジェクトに永続化されます。

ビューステートを保存すると、この文字列オブジェクトは HTML hidden 要素に格納された変数としてクライアントに返されます。カスタム サーバー コントロールを作成する場合は、このメソッドをオーバーライドし、サーバー コントロールの ViewState プロパティを変更することによって効率を向上させることができます。

プラットフォーム

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 名前空間
IsTrackingViewState
LoadViewState
TrackViewState
ViewState