PersonalizationAdministration.ResetState 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
根據集合中包含的項目來重設基礎資料存放區中的個人化資料。
public:
static int ResetState(System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ data);
public static int ResetState (System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection data);
static member ResetState : System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection -> int
Public Shared Function ResetState (data As PersonalizationStateInfoCollection) As Integer
參數
PersonalizationStateInfo 物件的集合,指出應該重設的資料。
傳回
已重設的資料列之數目。
例外狀況
data
為 null
。
data
為空集合。
-或-
集合內某個項目為 null
。
-或-
集合內某個 UserPersonalizationStateInfo 執行個體的路徑值為 null
或空字串 ("")。
-或-
集合內某個 UserPersonalizationStateInfo 執行個體的 user
值為 null
、空字串,或包含逗號。
-或-
組態中定義的個人化提供者之提供者不是正確的型別。
-或-
任一參數的字串長度大於 256 個字元。
預設的提供者指出已刪除的資料行數目為負數。
備註
這個方法會根據 PersonalizationStateInfo 集合中包含的物件,重設基礎數據存放區中的個人化數據。 您可以使用此方法,根據集合的內容選擇性地刪除共用和每個用戶數據的混合。 SharedPersonalizationStateInfo 物件表示頁面的共享數據將會重設; UserPersonalizationStateInfo 物件表示特定頁面的個別用戶數據將會重設。
注意
這個方法不保證所有重設都會發生在單一交易內,因為集合會指向隨機的個人化數據集。
集合不是錯誤,無法包含參考不存在資料的物件。