WebPart.SetPersonalizationDirty メソッド

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)

パラメーター

例外

注釈

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

こちらもご覧ください

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

protected:
 void SetPersonalizationDirty();

protected void SetPersonalizationDirty();

member this.SetPersonalizationDirty : unit -> unit

Protected Sub SetPersonalizationDirty ()

例外

注釈

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

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

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

こちらもご覧ください

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