PersonalizationProvider.GetCountOfState 方法

  • 参考

定义

命名空间:
System.Web.UI.WebControls.WebParts
程序集:
System.Web.dll

在派生类中重写时，返回基础数据存储区中存在于指定范围内的行数。

public:
 abstract int GetCountOfState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query);
public abstract int GetCountOfState (System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query);
abstract member GetCountOfState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery -> int
Public MustOverride Function GetCountOfState (scope As PersonalizationScope, query As PersonalizationStateQuery) As Integer

参数

scope
PersonalizationScope

要查询的个性化设置信息的 PersonalizationScope。 此值不能为 null。

query
PersonalizationStateQuery

包含查询的 PersonalizationStateQuery。 此值可为 null。

返回

Int32

针对指定 scope 参数的基础数据存储区的行数。

注解

此方法是用于检索个性化数据计数的管理方法的抽象定义。 派生实现应遵循下面所述的逻辑。

此方法将查询通配符传递给基础数据存储。 对通配符的支持目前取决于每个提供程序如何处理字符，例如星号 (*) 、百分比符号 (%) 或下划线 (_) 。

通常，对于符合 SQL 的数据存储，可以对部分路径执行通配符搜索，其中通配符出现在 属性中 PathToMatch 搜索字符串文本的开头、结尾或中间。 例如，若要查找以“~/vdir”开头的所有路径，属性 PathToMatch 将设置为“~/vdir%”。

同样，对部分用户名的通配符搜索可以在属性的文本字符串 UsernameToMatch 中的任何点显示通配符。 例如，若要查找以“John”开头的所有用户名，参数 UsernameToMatch 将类似于“John%”。

以下查询约束适用：

  • 如果仅scope提供 ，且 query 为 null 或 返回null或默认值时的所有属性query，则将对与所指示scope参数匹配的所有记录进行计数。

  • PathToMatch如果 属性不null为 ，则还会根据与 值匹配PathToMatch的路径筛选计数记录。

  • UsernameToMatch如果该属性不null为 ，则还会根据与属性值匹配UsernameToMatch的用户名筛选计数记录。

  • UserInactiveSinceDate如果 属性不等于 MaxValue，则还会筛选计数记录，以仅返回与非活动用户关联的记录。 比较包括属性小于或等于 属性的UserInactiveSinceDate记录LastActivityDate。

请注意，此方法不会验证查询参数的组合。 例如，代码可以请求与共享范围中的特定用户名关联的个性化设置状态记录计数。 由于用户名不与共享信息关联，因此返回的计数将为零。

可能返回非零计数的参数组合包括：

适用于