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 ，而是放置在 WebPartZoneBase 區域內以參與 Web Parts 應用程式。

另請參閱

• ASP.NET 網頁零件控制

protected:
 void SetPersonalizationDirty();

protected void SetPersonalizationDirty();

member this.SetPersonalizationDirty : unit -> unit

Protected Sub SetPersonalizationDirty ()

例外狀況

備註

此 SetPersonalizationDirty 方法會設定一個旗標，表示控制狀態資料已在控制 WebPart 點上被更改（個人化），因此 WebPartManager 控制項需要將個人化資料持久保存至長期儲存。

通常 它 WebPartManager 會持續執行控制項的個人化變更 WebPart ，開發者不需要呼叫該 SetPersonalizationDirty 方法。 但有兩種情況下，開發者確實需要呼叫這個方法。 第一種情況是在 HTTP GET 請求頁面時，控制狀態資料被更改。 預設情況下，請求期間 GET 對控制狀態資料的變更不會被持久化（出於安全考量）。 但此 SetPersonalizationDirty 方法在此情況下，提供了一種持續存在合法個人化變更 WebPart 控制的方法。

第二種呼叫此 SetPersonalizationDirty 方法的情況發生在對頁面的 HTTP POST 請求時。 若控制 WebPart 項具有複雜的個人化屬性（例如包含 ArrayList 物件的屬性），且在請求 POST 時該屬性中的控制狀態資料被個人化，開發者必須呼叫該 SetPersonalizationDirty 方法以確保變更被持久化。

另請參閱

• ASP.NET 網頁零件控制