WebPart.SetPersonalizationDirty 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
設定旗標,指出已變更置於 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
參數中的物件為 null
。
控制項沒有與網頁相關聯。
-或- 衍生自 WebPart 的控制項。 衍生自 WebPart 的控制項應該改用受保護的 SetPersonalizationDirty() 方法。
與控制項相關聯的網頁沒有 WebPartManager。
備註
方法 WebPart.SetPersonalizationDirty 的用途 WebPart.SetPersonalizationDirty() 與 方法相同,這是設定旗標,指出在 HTTP GET
要求期間,控制項狀態資料已變更 (個人化) 。 這些方法之間的差異在於 WebPart.SetPersonalizationDirty 方法用於不繼承自 WebPart 類別的伺服器控制項,但會放在 WebPartZoneBase 區域中以參與Web 組件應用程式。
另請參閱
適用於
SetPersonalizationDirty()
設定旗標,指出已變更目前 WebPart 控制項執行個體的個人化資料。
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 方法,以確保變更會保存。