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 類別的伺服器控制項，但會放在 WebPartZoneBase 區域中以參與Web 組件應用程式。

另請參閱

• 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 方法。 但有兩種情況是開發人員需要呼叫此方法。 第一個案例是當控制項狀態資料在 HTTP GET 要求期間變更為頁面時。 根據預設，在要求期間 GET 控制狀態資料的變更不會保存， (安全性用途) 。 但是， SetPersonalizationDirty 此方法提供一種方式來保存控制項的合法個人化變更 WebPart 。

呼叫 SetPersonalizationDirty 方法的第二個案例會在頁面的 HTTP POST 要求期間發生。 WebPart如果控制項具有複雜的可個人化屬性 (，例如包含 ArrayList 物件) 的屬性，而且這些屬性中的控制項狀態資料會在要求期間 POST 個人化，開發人員必須呼叫 SetPersonalizationDirty 方法，以確保變更會保存。

另請參閱

• ASP.NET Web 組件控制項