DataControlField.SaveViewState メソッド

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

DataControlField.SaveViewState メソッド

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

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

名前空間: 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

戻り値
DataControlField ビューステートへの変更を格納するオブジェクト。オブジェクトに関連付けられているビューステートがない場合、メソッドは 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

参照

関連項目
DataControlField クラス
DataControlField メンバ
System.Web.UI.WebControls 名前空間
IsTrackingViewState
LoadViewState
TrackViewState
ViewState