共用方式為


PersonalizationProvider.ResetState 方法

定義

在衍生類別中覆寫時,會根據指定的參數,刪除基礎資料存放區中的個人化狀態。

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[]

要刪除之個人化資訊的使用者名稱。

傳回

刪除的資料列數目。

備註

此方法是用來刪除個人化資料之系統管理方法的抽象定義。 衍生實作應遵循以下所述的邏輯。

這個方法不支援萬用字元搜尋。 如果個人化提供者從交易感知資料存放區公開資料,這個方法應該以單一不可部分完成的交易的形式執行其作業。

只允許下列參數組合:

  • 參數 scope 已設定,所有其他參數都會設定為 null 。 這個組合會刪除與 所 scope 指示之個人化範圍相關聯的所有網頁元件個人化資料。

  • 參數 scope 已設定,且 paths 參數至少包含一個值。 這個組合會刪除 所指示 scope 之個人化範圍中指定路徑或路徑的所有網頁元件個人化資料。

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

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

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

  • usernames當 設定為 Sharedscope ,無法提供 參數。

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

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

  • null 不允許值。

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

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

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

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

適用於