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 網頁元件控制件

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 網頁元件控制件