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 パーツ コントロール