PersonalizationAdministration.ResetUserState 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
重置底層資料儲存中指定參數的所有每位使用者狀態。
多載
| 名稱 | Description |
|---|---|
| ResetUserState(String) |
重置底層資料儲存中指定路徑的所有每位使用者狀態。 |
| ResetUserState(String[]) |
重置底層資料儲存中指定路徑的所有用戶狀態。 |
| ResetUserState(String, String) |
在底層資料儲存中,針對指定的使用者名稱與路徑組合,重置每位使用者的狀態。 |
| ResetUserState(String, String[]) |
在底層資料儲存中,針對頁面及指定的使用者,重置每位使用者的狀態。 |
ResetUserState(String)
重置底層資料儲存中指定路徑的所有每位使用者狀態。
public:
static int ResetUserState(System::String ^ path);
public static int ResetUserState(string path);
static member ResetUserState : string -> int
Public Shared Function ResetUserState (path As String) As Integer
參數
- path
- String
與個人化狀態資訊相關聯的頁面路徑,該資訊將被重置。
傳回
被重置的列數。
例外狀況
path 是 null。
預設提供者顯示刪除的列數為負數。
備註
此方法回傳被重置的列數。 嘗試重置不存在的共享狀態並非錯誤。
另請參閱
適用於
ResetUserState(String[])
重置底層資料儲存中指定路徑的所有用戶狀態。
public:
static int ResetUserState(cli::array <System::String ^> ^ usernames);
public static int ResetUserState(string[] usernames);
static member ResetUserState : string[] -> int
Public Shared Function ResetUserState (usernames As String()) As Integer
參數
- usernames
- String[]
一組應重置每位使用者資料的使用者名稱陣列。
傳回
被重置的列數。
例外狀況
usernames 是 null。
usernames 是一個零長度的陣列。
-或-
的 usernames 成員要麼 null是,包含逗號,要麼是裁剪後的空字串(“”)。
-或-
設定中定義的個人化提供者的提供者類型不正確。
-或-
任何參數的字串長度都大於 256 個字元。
預設提供者顯示刪除的列數為負數。
備註
此方法會重置與參數中 usernames 使用者相關的所有用戶狀態,並回傳被重置的列數。
嘗試重置不存在的共享狀態並非錯誤。
另請參閱
適用於
ResetUserState(String, String)
在底層資料儲存中,針對指定的使用者名稱與路徑組合,重置每位使用者的狀態。
public:
static bool ResetUserState(System::String ^ path, System::String ^ username);
public static bool ResetUserState(string path, string username);
static member ResetUserState : string * string -> bool
Public Shared Function ResetUserState (path As String, username As String) As Boolean
參數
- path
- String
與個人化狀態資訊相關聯的頁面路徑,該資訊將被重置。
- username
- String
與要重置的個人化資料相關的使用者名稱。
傳回
被重置的列數。
例外狀況
path 或 username 為 null。
path 或 username 為裁剪後的空字串(“”)。
-或-
username 包含逗號。
-或-
設定中定義的個人化提供者的提供者類型不正確。
-或-
任何參數的字串長度都大於 256 個字元。
預設提供者顯示刪除的列數為負數。
備註
嘗試重置不存在的使用者狀態並非錯誤。
另請參閱
適用於
ResetUserState(String, String[])
在底層資料儲存中,針對頁面及指定的使用者,重置每位使用者的狀態。
public:
static int ResetUserState(System::String ^ path, cli::array <System::String ^> ^ usernames);
public static int ResetUserState(string path, string[] usernames);
static member ResetUserState : string * string[] -> int
Public Shared Function ResetUserState (path As String, usernames As String()) As Integer
參數
- path
- String
與個人化狀態資訊相關聯的頁面路徑,該資訊將被重置。
- usernames
- String[]
與個人化資料相關聯的使用者名稱要重置。
傳回
被重置的列數。
例外狀況
path 或 usernames 為 null。
path 是裁剪後空字串(“”)。
-或-
的 usernames 成員是 null,經過修剪後的空字串,或包含逗號。
-或-
usernames 是一個零長度的陣列。
-或-
設定中定義的個人化提供者的提供者類型不正確。
-或-
任何參數的字串長度都大於 256 個字元。
預設提供者顯示刪除的列數為負數。
備註
此方法會重置每位使用者所關聯的底層資料儲存庫中,該資料儲存包含 usernames 於指定的 path頁面參數中。
嘗試重置不存在的使用者狀態並非錯誤。