WebControl.SaveViewState WebControl.SaveViewState WebControl.SaveViewState WebControl.SaveViewState Method

定義

TrackViewState() メソッドが呼び出された後に変更された状態を保存します。Saves any state that was modified after the TrackViewState() method was invoked.

protected:
 override System::Object ^ SaveViewState();
protected override object SaveViewState ();
override this.SaveViewState : unit -> obj
Protected Overrides Function SaveViewState () As Object

戻り値

コントロールの現在のビュー ステートを格納するオブジェクト。このコントロールに関連付けられたビュー ステートがない場合は nullAn object that contains the current view state of the control; otherwise, if there is no view state associated with the control, null.

注釈

メソッドSaveViewStateは、主にコントロールの開発者によって使用されます。The SaveViewState method is used primarily by control developers.

ビューステートは、サーバーコントロールのプロパティの累積値です。View state is the cumulative values of the properties for a server control. これらの値は、 ViewState StateBagクラスのインスタンスであるサーバーコントロールのプロパティに自動的に配置されます。These values are placed automatically in the ViewState property for the server control, which is an instance of the StateBag class. ViewStateプロパティ値は、サーバーコントロールのライフサイクルの状態の保存ステージの後に文字列オブジェクトに永続化されます。The ViewState property value is then persisted to a string object after the save state stage of the life cycle for the server control. 詳細については、「 ASP.NET Page ライフサイクルの概要」を参照してください。For more information, see ASP.NET Page Life Cycle Overview.

ビューステートが保存されると、この文字列オブジェクトは、非表示の HTML input要素に格納されている変数としてクライアントに返されます。When view state is saved, this string object is returned to the client as a variable that is stored in a hidden HTML input element. カスタムサーバーコントロールを作成する場合は、 SaveViewStateメソッドをオーバーライドし、サーバーコントロールのViewStateプロパティを変更することで、効率を向上させることができます。When you author custom server controls, you can improve efficiency by overriding the SaveViewState method and modifying the ViewState property for your server control. 詳細については、「 ASP.NET State Management の概要」を参照してください。For more information, see ASP.NET State Management Overview.

適用対象

こちらもご覧ください