SqlPersonalizationProvider.ResetState 方法

定義

命名空間:

System.Web.UI.WebControls.WebParts

組件:

System.Web.dll

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

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

刪除的資料列數目。

例外狀況

ArgumentException

paths 或 usernames 參數是空白陣列。

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

ArgumentOutOfRangeException

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

備註

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

只允許下列參數組合：

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

• 參數 scope 已設定，且 paths 參數至少包含一個值。 這個組合會刪除指定路徑或路徑的所有Web 組件個人化資料，這些路徑位於 所 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 使用者名稱不能包含逗號。

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

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