WebPartPersonalization.Save メソッド

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

WebPartPersonalization.Save メソッド

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

現在のページ、スコープ、およびユーザーのパーソナル化データを、基になるデータ ストアに保存します。

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

Visual Basic (宣言)

Protected Overridable Sub
 Save

Visual Basic (使用法)

Me.Save

C#

protected virtual void Save ()

C++

protected:
virtual void Save ()

J#

protected void Save ()

JScript

protected function Save ()

例外

例外の種類

条件

InvalidOperationException

現在のユーザーが、ModifyStateUserCapability という機能を保持していません。 または WebPartPersonalization のインスタンスが有効なパーソナル化プロバイダを参照できません。 または WebPartPersonalization のインスタンスに関連付けられたパーソナル化プロバイダが存在しません。このエラーは、Load の呼び出しの前にこのメソッドを呼び出した場合に発生することがあります (パーソナル化プロバイダの参照は Load の呼び出し時に取得されます)。 または パーソナル化状態が読み込まれていません。 または 関連する WebPartManager の Page インスタンスが null 参照 (Visual Basic では Nothing) です。 または WebPartManager コントロールの関連する Page インスタンスの Request プロパティの値が null 参照 (Visual Basic では Nothing) です。

解説

このメソッドは、WebPartManager コントロールの SaveStateComplete イベント中に呼び出されます。内部的には、このメソッドは、プロバイダ側の SavePersonalizationState メソッドを呼び出します。

現在実行中のユーザーが、現在の WebPartUserCapability インスタンス内に ModifyStateUserCapability という機能を保持していないときにパーソナル化データを保存しようとすると、InvalidOperationException 例外が発生します。この動作は、WebPartManager コントロールが、プロテクト メソッドである Save を直接呼び出した場合にだけ発生します。ASP.NET の実装では、内部のヘルパー メソッドが実際に呼び出されて保存が実行されます。このヘルパー メソッドは、現在実行中のユーザーがデータを変更する権限を持っていない場合でも、エラーなしで制御を戻します。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
WebPartPersonalization クラス
WebPartPersonalization メンバ
System.Web.UI.WebControls.WebParts 名前空間
WebPartPersonalization クラス
その他の技術情報
ASP.NET Web パーツ ページ
Web パーツのパーソナル化の概要
チュートリアル : ユーザー コントロールに Web パーツ パーソナル化を実装する
Web パーツのパーソナル化