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

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

Int32

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

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

-或-

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

-或-

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

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

-或-

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

HttpException

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

這個方法會傳回所指定 usernameToMatch基礎數據存放區中個別用戶個人化項目數目的計數。

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

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

參數 usernameToMatch 可以是 null。如果設定為 null，則會在執行查詢時忽略參數。參數 usernameToMatch 允許有逗號 (，) ，因為某些數據存放區，例如執行 Microsoft SQL Server 的數據存放區，允許逗號做為通配符。