DataControlField.SaveViewState メソッド

  • リファレンス

定義

名前空間:
System.Web.UI.WebControls
アセンブリ:
System.Web.dll

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

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

戻り値

Object

DataControlField ビューステートへの変更を格納するオブジェクト。 オブジェクトに関連付けられているビューステートがない場合、メソッドは null を返します。

注釈

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

ビュー ステートは、サーバー コントロールのプロパティの値の累積です。 これらの値は、 クラスのインスタンスであるサーバー コントロールの ViewState プロパティに自動的に StateBag 配置されます。 このプロパティの値は、サーバー コントロールのライフ サイクルの保存状態ステージの後に文字列オブジェクトに永続化されます。

ビュー ステートが保存されると、HTML hidden 要素に格納されている変数として文字列がクライアントに返されます。 カスタム サーバー コントロールを作成するときに、このメソッドをオーバーライドし、サーバー コントロールの ViewState プロパティを変更することで、効率を向上させることができます。 詳細については、「 ビュー ステートの概要」ASP.NET 参照してください。

適用対象

こちらもご覧ください