WebPart.SetPersonalizationDirty メソッド

定義

名前空間:

System.Web.UI.WebControls.WebParts

アセンブリ:

System.Web.dll

WebPartZoneBase ゾーンに配置された Web パーツ コントロールやサーバー コントロールのパーソナル化データが変更されていることを示すフラグを設定します。

オーバーロード

SetPersonalizationDirty(Control)	WebPartZoneBase ゾーンにある、指定されたサーバー コントロールのパーソナル化データが変更されていることを示すフラグを設定します。
SetPersonalizationDirty()	現在の WebPart コントロールのインスタンスのパーソナル化データが変更されていることを示すフラグを設定します。

SetPersonalizationDirty(Control)

WebPartZoneBase ゾーンにある、指定されたサーバー コントロールのパーソナル化データが変更されていることを示すフラグを設定します。

public:
 static void SetPersonalizationDirty(System::Web::UI::Control ^ control);

public static void SetPersonalizationDirty (System.Web.UI.Control control);

static member SetPersonalizationDirty : System.Web.UI.Control -> unit

Public Shared Sub SetPersonalizationDirty (control As Control)

パラメーター

control

Control

パーソナル化データが変更されている Control。

例外

ArgumentNullException

control パラメーター内のオブジェクトが null です。

ArgumentException

コントロールがページに関連付けられていません。

- または -

コントロールが WebPart から派生しています。 WebPart から派生するコントロールは、SetPersonalizationDirty() プロテクト メソッドを代わりに使用する必要があります。

InvalidOperationException

コントロールに関連付けられているページに、WebPartManager がありません。

注釈

メソッドの目的WebPart.SetPersonalizationDirty()は WebPart.SetPersonalizationDirty メソッドと同じです。これは、HTTP GET 要求中にサーバー コントロールで制御状態データが変更 (カスタマイズ) されたことを示すフラグを設定することです。 これらのメソッドの違いは、 WebPart.SetPersonalizationDirty メソッドは、 クラスから WebPart 継承されず、Web パーツ アプリケーションに参加するためにゾーン内 WebPartZoneBase に配置されるサーバー コントロールに使用される点です。

こちらもご覧ください

• ASP.NET Web パーツ コントロール

SetPersonalizationDirty()

現在の WebPart コントロールのインスタンスのパーソナル化データが変更されていることを示すフラグを設定します。

protected:
 void SetPersonalizationDirty();

protected void SetPersonalizationDirty ();

member this.SetPersonalizationDirty : unit -> unit

Protected Sub SetPersonalizationDirty ()

例外

InvalidOperationException

WebPartManager が nullです。

注釈

メソッドは SetPersonalizationDirty 、コントロールの状態データが変更 (個人用設定) WebPart されたこと、およびコントロールがパーソナル化データを長期ストレージに保持する必要があることを WebPartManager 示すフラグを設定します。

通常、 は WebPartManager 、開発者が メソッドを呼び出す必要なく、コントロールの WebPart パーソナル化の変更を SetPersonalizationDirty 保持します。 ただし、開発者がこのメソッドを呼び出す必要があるケースは 2 つあります。 最初のケースは、ページへの HTTP GET 要求中に制御状態データが変更されたときです。 既定では、要求中の状態データの制御に対する GET 変更は保持されません (セキュリティ上の理由から)。 ただし、 メソッドは SetPersonalizationDirty 、この場合にコントロールに対する正当なパーソナル化の変更を保持する WebPart 方法を提供します。

メソッドを呼び出すための 2 番目の SetPersonalizationDirty ケースは、ページへの HTTP POST 要求中に発生します。 コントロールに WebPart 複雑なカスタマイズ可能なプロパティ (オブジェクトを含む ArrayList プロパティなど) があり、それらのプロパティのコントロール状態データが要求時に POST カスタマイズされている場合、開発者は メソッドを呼び出して SetPersonalizationDirty 変更が永続化されるようにする必要があります。

こちらもご覧ください

• ASP.NET Web パーツ コントロール