WebPartPersonalization.Save 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將目前網頁、範圍和使用者的個人化資料儲存至基礎資料存放區。
protected:
virtual void Save();
protected virtual void Save ();
abstract member Save : unit -> unit
override this.Save : unit -> unit
Protected Overridable Sub Save ()
例外狀況
目前的使用者沒有稱為 ModifyStateUserCapability 的功能。
-或-
WebPartPersonalization 執行個體無法參考有效的個人化提供者。
-或-
目前沒有與 WebPartPersonalization 執行個體相關聯的個人化提供者。 如果在呼叫 Load() (呼叫 Load() 時取得個人化提供者參考) 之前呼叫這個方法,則會發生這種情況。
-或-
未載入個人化狀態。
-或-
相關聯 Page 的 WebPartManager 執行個體為 null
。
-或-
Request 控制項之相關聯 WebPartManager 執行個體上的 Page 屬性值為 null
。
備註
這個方法會在控件的 SaveStateComplete 事件期間WebPartManager呼叫。 在內部,方法會在提供者上呼叫 SavePersonalizationState 方法。
當目前執行的用戶沒有目前WebPartUserCapability實例內 (呼叫ModifyStateUserCapability的功能時,嘗試儲存個人化數據,) 會導致InvalidOperationException例外狀況。 請注意,只有在控件直接呼叫受保護的Save方法時WebPartManager,才會發生這種情況。 在 ASP.NET 實作中,實際上會呼叫內部協助程式方法來執行儲存,如果目前執行的使用者沒有修改數據的許可權,則這個協助程式方法會以無訊息方式傳回。