PersonalizationAdministration.FindUserState 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
根據指定的參數傳回每一使用者個人化狀態資訊的集合。
多載
FindUserState(String, String) |
根據使用者名稱和網頁路徑傳回每一使用者個人化狀態資訊的集合。 |
FindUserState(String, String, Int32, Int32, Int32) |
根據指定的參數傳回每一使用者個人化狀態資訊的集合。 |
FindUserState(String, String)
根據使用者名稱和網頁路徑傳回每一使用者個人化狀態資訊的集合。
public:
static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindUserState (string pathToMatch, string usernameToMatch);
static member FindUserState : string * string -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindUserState (pathToMatch As String, usernameToMatch As String) As PersonalizationStateInfoCollection
參數
- pathToMatch
- String
符合的網頁路徑。
- usernameToMatch
- String
符合的使用者名稱,其中包括與網頁相關聯的個人化資料。
傳回
PersonalizationStateInfoCollection,包含每一使用者個人化狀態資訊。
例外狀況
pathToMatch
或 usernameToMatch
於修剪前後為空字串 ("")。
-或-
組態中定義的個人化提供者之提供者不是正確的型別。
-或-
任一參數的字串長度大於 256 個字元。
範例
下列程式碼範例會示範如何使用 FindUserState 方法。 您可以在類別概觀主題中找到 PersonalizationAdministration 完整的範例。
重要
這個範例有一個可接受使用者輸入的文字方塊,這可能會造成安全性威脅。 根據預設,ASP.NET Web 網頁會驗證使用者輸入未包含指令碼或 HTML 項目。 如需詳細資訊,請參閱 Script Exploits Overview (指令碼攻擊概觀)。
protected void Button1_Click(object sender, EventArgs e)
{
if (TextBox3.Text != null)
{
PersonalizationStateInfoCollection findresult;
findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text);
if (findresult.Count != 0)
{
Label4.Text = findresult.Count + " user(s) found";
Label4.Visible = true;
}
else
{
Label4.Text = "No users found.";
Label4.Visible = true;
}
}
else
{
Label4.Text = "You must enter a user name to find.";
}
}
備註
這個方法會傳回 實例的 UserPersonalizationStateInfo 集合,其中 pathToMatch
參數值符合頁面的路徑,並 usernameToMatch
符合與該頁面相關聯的個人化資料的使用者名稱。 集合只 UserPersonalizationStateInfo 包含 實例。
此方法會將參數萬用字元傳遞至基礎個人化提供者,因此資料存放區如何處理這些字元,取決於提供者如何處理星號 (*) 、百分比符號 (%) 或底線 (_) 。
一般而言,對於符合 SQL 規範的資料存放區,您可以在部分路徑上執行萬用字元搜尋,其中萬用字元會出現在屬性的 PathToMatch 開頭、結尾或搜尋字串文字中間。 例如,若要尋找以 「~/vdir」 開頭的所有路徑,屬性 PathToMatch 會設定為 「~/vdir%」。
同樣地,部分使用者名稱的萬用字元搜尋可能會有萬用字元出現在屬性文字字串 UsernameToMatch 中的任何點。 例如,若要尋找以 「John」 開頭的所有使用者名稱, UsernameToMatch 屬性看起來會像 「John%」。
使用預設個人化提供者時, PersonalizationStateInfo 衍生物件會依字母順序傳回,並以路徑和使用者名稱的組合來依遞增順序排序。 集合中物件的排序是由提供者決定。
pathToMatch
和 usernameToMatch
可以是 null
。 參數 usernameToMatch
可以有逗號 (,) ,因為某些資料存放區,例如執行 Microsoft SQL Server 的資料存放區,允許逗號做為萬用字元。
另請參閱
適用於
FindUserState(String, String, Int32, Int32, Int32)
根據指定的參數傳回每一使用者個人化狀態資訊的集合。
public:
static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindUserState (string pathToMatch, string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);
static member FindUserState : string * string * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindUserState (pathToMatch As String, usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection
參數
- pathToMatch
- String
符合的網頁路徑。
- usernameToMatch
- String
符合的使用者名稱,其中包括與網頁相關聯的個人化資料。
- pageIndex
- Int32
要傳回的結果網頁之以零起始的索引。
- pageSize
- Int32
要傳回的資料錄數。
- totalRecords
- Int32
可用的資料錄總數。
傳回
PersonalizationStateInfoCollection,包含每一使用者個人化狀態資訊。
例外狀況
pathToMatch
或 usernameToMatch
於修剪前後為空字串 ("")。
-或-
pageIndex
小於零。
-或-
pageSize
小於或等於零。
-或-
和 pageSize
的組合 pageIndex
超過Int32.MaxValue。
-或-
組態中定義的個人化提供者之提供者不是正確的型別。
-或-
任一參數的字串長度大於 256 個字元。
範例
下列程式碼範例會示範如何使用 FindUserState 方法。 您可以在類別概觀主題中找到 PersonalizationAdministration 完整的範例。
重要
這個範例有一個可接受使用者輸入的文字方塊,這可能會造成安全性威脅。 根據預設,ASP.NET Web 網頁會驗證使用者輸入未包含指令碼或 HTML 項目。 如需詳細資訊,請參閱 Script Exploits Overview (指令碼攻擊概觀)。
protected void Button1_Click(object sender, EventArgs e)
{
if (TextBox3.Text != null)
{
PersonalizationStateInfoCollection findresult;
findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text);
if (findresult.Count != 0)
{
Label4.Text = findresult.Count + " user(s) found";
Label4.Visible = true;
}
else
{
Label4.Text = "No users found.";
Label4.Visible = true;
}
}
else
{
Label4.Text = "You must enter a user name to find.";
}
}
備註
這個方法會傳回 實例的 UserPersonalizationStateInfo 集合,其中 pathToMatch
參數值符合頁面的路徑,並 usernameToMatch
符合與該頁面相關聯的個人化資料的使用者名稱。 集合只 UserPersonalizationStateInfo 包含 實例。
此方法會將參數萬用字元傳遞至基礎個人化提供者,因此資料存放區如何處理這些字元,取決於提供者如何處理字元作為星號 (*) 、百分比符號 (%) 或底線 (_) 。
一般而言,對於符合 SQL 規範的資料存放區,您可以在部分路徑上執行萬用字元搜尋,其中萬用字元會出現在屬性的 PathToMatch 開頭、結尾或搜尋字串文字中間。 例如,若要尋找以 「~/vdir」 開頭的所有路徑,屬性 PathToMatch 會設定為 「~/vdir%」。
同樣地,部分使用者名稱的萬用字元搜尋可能會有萬用字元出現在屬性文字字串 UsernameToMatch 中的任何點。 例如,若要尋找以 「John」 開頭的所有使用者名稱, UsernameToMatch 屬性看起來會像 「John%」。
使用預設個人化提供者時, PersonalizationStateInfo 衍生物件會依字母順序傳回,並以路徑和使用者名稱的組合來依遞增順序排序。 集合中物件的順序是由提供者決定。
pathToMatch
和 usernameToMatch
可以是 null
。 參數 usernameToMatch
可以有逗號 (,) ,因為某些資料存放區,例如執行 Microsoft SQL Server 的資料存放區,允許逗號做為萬用字元。
傳回的資料受限於 pageIndex
和 ,其中 pageIndex
控制要傳回的記錄,並 pageSize
控制要傳回 pageSize
的記錄數目。 例如,如果 pageIndex
設定為 0 且 pageSize
設定為 25,則傳回的資料會是前 25 個專案。 如果 pageIndex
設定為 1 且 pageSize
設定為 25,則傳回的資料會是專案 26 到 50。 參數會 totalRecords
傳回可用的記錄總數。
另請參閱
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應