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。
備註
此方法在控制WebPartManager組事件期間SaveStateComplete被呼叫。 在內部,方法會呼叫提供者的方法 SavePersonalizationState 。
當目前執行的使用者沒有在該ModifyStateUserCapability實例中呼叫WebPartUserCapability的功能時,嘗試儲存個人化資料會導致InvalidOperationException例外。 請注意,這只有在控制 WebPartManager 項直接呼叫受保護 Save 方法時才成立。 在 ASP.NET 實作中,實際上會呼叫一個內部輔助方法來執行儲存,若執行中的使用者沒有修改資料的權限,該輔助方法會靜默回傳。