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 的数据存储）允许逗号作为通配符。