PersonalizationAdministration.GetCountOfUserState(String) 方法

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

傳回基礎資料存放區中的個人化狀態項目計數，這些項目針對指定使用者存在。

public:
 static int GetCountOfUserState(System::String ^ usernameToMatch);

public static int GetCountOfUserState (string usernameToMatch);

static member GetCountOfUserState : string -> int

Public Shared Function GetCountOfUserState (usernameToMatch As String) As Integer

與要擷取之個人化狀態資訊相關聯的使用者名稱。

指定使用者的個人化狀態項目數目。

usernameToMatch 於修剪後為空字串 ("")。

-或-

組態中定義的個人化提供者之提供者不是正確的型別。

-或-

任一參數的字串長度大於 256 個字元。

在嘗試建立及初始化其中一個設定的個人化提供者的執行個體時，發生組態例外狀況。

-或-

找不到組態中定義的預設個人化提供者。

HttpException

預設提供者傳回的負數計數。

這個方法會傳回所指定 usernameToMatch 基礎資料存放區中個別使用者個人化專案數目的計數。

請注意，參數 usernameToMatch 可以包含萬用字元。此方法會將萬用字元傳遞至基礎資料存放區。萬用字元支援目前取決於每個提供者如何處理星號 (*) 、百分比符號 (%) 或底線 (_) 等字元。

一般而言，對於符合SQL規範的資料存放區，部分使用者名稱的萬用字元搜尋可能會讓萬用字元出現在屬性的文字字串 UsernameToMatch 中的任何一點。例如，若要尋找開頭為「John」的所有使用者名稱， UsernameToMatch 參數看起來會像「John%」。

參數 usernameToMatch 可以是 null 。如果設定為 null ，則會在執行查詢時忽略參數。參數 usernameToMatch 允許有逗號 (，) ，因為某些資料存放區，例如執行Microsoft SQL Server，允許逗號做為萬用字元。