語言

PersonalizationProvider.ResetState 方法

定義

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

當在派生類別中覆寫時，會根據指定的參數從底層資料儲存中刪除個人化狀態。

public:
 abstract int ResetState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, cli::array <System::String ^> ^ paths, cli::array <System::String ^> ^ usernames);
public abstract int ResetState(System.Web.UI.WebControls.WebParts.PersonalizationScope scope, string[] paths, string[] usernames);
abstract member ResetState : System.Web.UI.WebControls.WebParts.PersonalizationScope * string[] * string[] -> int
Public MustOverride Function ResetState (scope As PersonalizationScope, paths As String(), usernames As String()) As Integer

參數

scope
PersonalizationScope

PersonalizationScope個人化資訊需要重置。 這個值不能是 null。

paths
String[]

個人化資訊的路徑將被刪除。

usernames
String[]

個人化資訊的使用者名稱將被刪除。

傳回

Int32

刪除的列數。

備註

此方法是一種抽象定義的行政方法，用於刪除個人化資料。 衍生實作應遵循以下所述邏輯。

此方法不支援萬用字元搜尋。 若個人化提供者從交易感知資料庫中公開資料，此方法應以單一原子交易方式執行操作。

僅允許以下參數組合：

  • scope參數 為 ，其他參數皆為 null。 此組合刪除所有與個人化 scope範圍相關的網頁零件個人化資料。

  • scope參數已設定paths，且參數至少包含一個值。 此組合刪除所有 Web Parts 個人化資料，該路徑由 所指示 scope的個人化範圍內。

  • scope參數設為 User，paths參數 設定且僅包含一個值，且usernames參數至少包含一個值。 此組合會刪除所有與該 usernames使用者相關聯的路徑上的使用者個人化網頁零件資料。

  • scope參數設為 User，paths參數設為 null，usernames且參數至少包含一個值。 此組合會刪除所有與該 usernames使用者相關的路徑上、每一位使用者的個人化網頁零件資料。

任何其他參數值組合皆無效，會拋出 ArgumentException 例外。 具體來說，以下兩種組合是不被允許的：

  • usernames當 scope 設定為 Shared時，無法提供參數。

  • paths當usernames參數不是 null時，該參數不能包含多個項目。

各自陣列中包含的任何 paths 和 usernames 參數值必須符合以下驗證規則。 若參數陣列中任一成員的驗證規則失敗， ArgumentException 則會拋出例外。 驗證規則如下：

  • null 不允許使用數值。

  • 空字串（“”）則不被允許。 參數應在執行空字串檢查前先修剪。

  • 參數 usernames 不得包含逗號（，）。

  • 參數長度 paths 對 SQL 資料庫而言不得超過 256 個字元。

  • 參數長度 usernames 對 SQL 資料庫而言不得超過 256 個字元。

適用於