PersonalizationAdministration.ResetState 方法

  • 參考

定義

命名空間:
System.Web.UI.WebControls.WebParts
組件:
System.Web.dll

根據集合中包含的項目來重設基礎資料存放區中的個人化資料。

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

參數

data
PersonalizationStateInfoCollection

PersonalizationStateInfo 物件的集合，指出應該重設的資料。

傳回

Int32

已重設的資料列之數目。

例外狀況

ArgumentNullException

data 為 null。

ArgumentException

data 為空集合。

-或-

集合內某個項目為 null。

-或-

集合內某個 UserPersonalizationStateInfo 執行個體的路徑值為 null 或空字串 ("")。

-或-

集合內某個 UserPersonalizationStateInfo 執行個體的 user 值為 null、空字串，或包含逗號。

-或-

組態中定義的個人化提供者之提供者不是正確的型別。

-或-

任一參數的字串長度大於 256 個字元。

ConfigurationErrorsException

在嘗試建立及初始化其中一個設定的個人化提供者的執行個體時，發生組態例外狀況。

-或-

找不到組態中定義的預設個人化提供者。

HttpException

預設的提供者指出已刪除的資料行數目為負數。

備註

此方法會根據 PersonalizationStateInfo 集合中包含的物件，重設基礎資料存放區中的個人化資料。 您可以使用此方法，根據集合的內容，選擇性地刪除共用和每個使用者資料的混合。 SharedPersonalizationStateInfo 物件表示頁面的共用資料將會重設; UserPersonalizationStateInfo 物件表示特定頁面的個別使用者資料將會重設。

注意

此方法不保證所有重設都會發生在單一交易內，因為集合會指向隨機的個人化資料集。

集合不包含參考不存在資料的物件，不是錯誤。

適用於

另請參閱