共用方式為


SqlPersonalizationProvider.ResetState 方法

定義

根據指定的參數,刪除基礎資料存放區中的個人化狀態資訊。

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

參數

scope
PersonalizationScope

PersonalizationScope,表示要查詢的個人化資訊。 這個值不能是 null

paths
String[]

Shared 範圍中要刪除之個人化資訊的路徑。

usernames
String[]

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

傳回

Int32

刪除的資料列數目。

例外狀況

pathsusernames 參數是空白陣列。

-或- 包含於各自陣列中的 pathsusernames 參數不符合驗證規則。

指定的 scope 不是 PersonalizationScope 列舉的成員。

備註

這個方法不支援萬用字元。

只允許下列參數組合:

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

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

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

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

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

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

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

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

  • null 不允許值。

  • 不允許修剪字串之後,空字串 (「」「) 。

  • 參數中包含的 usernames 使用者名稱不能包含逗號。

  • 參數中 paths 任何路徑的長度不能大於 256 個字元。

  • 參數中 usernames 任何使用者名稱的長度不能大於 256 個字元。

適用於