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 參數至少包含一個值。 這個組合會刪除 所指示 scope 之個人化範圍中指定路徑或路徑的所有網頁元件個人化資料。

• 參數 scope 設定為 User ， paths 參數會設定且只包含一個值，而且 usernames 參數至少包含一個值。 這個組合會刪除指定路徑的所有使用者個人化 Web 元件資料，該路徑與 中包含的 usernames 使用者或使用者相關聯。

• 參數 scope 設定為 User 、 paths 參數設定為 null ，而且 usernames 參數至少包含一個值。 這個組合會跨所有路徑刪除與 中包含的 usernames 使用者或使用者相關聯的所有個別使用者個人化 Web 元件資料。

參數值的任何其他組合都無效，而且會擲回 ArgumentException 例外狀況。 具體而言，不允許下列兩種組合：

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

• 當 paths 參數不是 null 時， usernames 參數不能包含多個專案。

包含在 paths 個別陣列中的任何 和 usernames 參數值都必須符合下列驗證規則。 如果參數陣列的任何成員有任何驗證規則失敗， ArgumentException 則會擲回例外狀況。 驗證規則如下：

• null 不允許值。

• 不允許空字串 (「」) 。 執行空字串檢查之前，應該先修剪參數。

• 參數 usernames 不能包含逗號 (，) 。

• SQL 資料庫的參數長度 paths 不能大於 256 個字元。

• SQL 資料庫的參數長度 usernames 不能大於 256 個字元。