PersonalizationAdministration.FindInactiveUserState 方法

定义

基于指定参数为非活动用户返回每名用户个性化状态信息的集合。

重载

FindInactiveUserState(String, String, DateTime)

基于指定参数为非活动用户返回每名用户个性化状态信息的集合。

FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)

基于指定参数为非活动用户返回每名用户个性化状态信息的集合。

FindInactiveUserState(String, String, DateTime)

基于指定参数为非活动用户返回每名用户个性化状态信息的集合。

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindInactiveUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, DateTime userInactiveSinceDate);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindInactiveUserState (string pathToMatch, string usernameToMatch, DateTime userInactiveSinceDate);
static member FindInactiveUserState : string * string * DateTime -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindInactiveUserState (pathToMatch As String, usernameToMatch As String, userInactiveSinceDate As DateTime) As PersonalizationStateInfoCollection

参数

pathToMatch
String

要匹配的页面的路径。

usernameToMatch
String

要匹配的用户名,该用户名含有与相应页面关联的个性化设置数据。

userInactiveSinceDate
DateTime

上一次访问用户的个性化设置信息的日期。

返回

包含每名用户个性化状态信息的 PersonalizationStateInfoCollection

例外

pathToMatchusernameToMatch 在修整前或修整后是空字符串 ("")。

- 或 -

配置中定义的个性化设置提供程序的提供程序类型不正确。

- 或 -

任何参数的字符串长度超过 256 个字符。

尝试创建和初始化已配置的个性化设置提供程序的一个实例时出现配置异常。

- 或 -

找不到配置中定义的默认个性化设置提供程序。

注解

此方法返回实例集合 UserPersonalizationStateInfo ,即每用户个性化设置状态信息,其中 pathToMatch 参数值与页面的路径匹配, usernameToMatch 匹配具有与该页面关联的个性化数据的用户名,并且用户被视为非活动状态。 换句话说,对于每个返回的 LastActivityDate 记录,用户的属性值小于或等于 userInactiveSinceDate。 返回的集合仅 UserPersonalizationStateInfo 包含 实例。

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

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

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

使用默认个性化设置提供程序时, PersonalizationStateInfo将按字母顺序返回派生的对象,并按路径和用户名的组合按升序排序。 集合中对象的顺序由提供程序确定。

如果 userInactiveSinceDateMaxValue,则此方法返回的值等效于 FindUserState

pathToMatchusernameToMatch 都可以是 null。 参数 usernameToMatch 可以包含逗号 (,) ,因为某些数据存储(如运行 Microsoft SQL Server 的数据存储)允许逗号作为通配符。

另请参阅

适用于

FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)

基于指定参数为非活动用户返回每名用户个性化状态信息的集合。

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindInactiveUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindInactiveUserState (string pathToMatch, string usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, out int totalRecords);
static member FindInactiveUserState : string * string * DateTime * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindInactiveUserState (pathToMatch As String, usernameToMatch As String, userInactiveSinceDate As DateTime, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

参数

pathToMatch
String

要匹配的页面的路径。

usernameToMatch
String

要匹配的用户名,该用户名含有与相应页面关联的个性化设置数据。

userInactiveSinceDate
DateTime

上一次访问个性化设置信息的日期。

pageIndex
Int32

要返回的结果页的索引(从零开始)。

pageSize
Int32

要返回的记录数。

totalRecords
Int32

可用记录的总数。

返回

包含每名用户个性化状态信息的 PersonalizationStateInfoCollection

例外

pathToMatchusernameToMatch 在修整前或修整后是空字符串 ("")。

- 或 -

pageIndex 小于零

- 或 -

pageSize 小于或等于零。

- 或 -

pageSize 的组合pageIndex超过了 Int32.MaxValue

- 或 -

配置中定义的个性化设置提供程序的提供程序类型不正确。

- 或 -

任何参数的字符串长度超过 256 个字符。

尝试创建和初始化已配置的个性化设置提供程序的一个实例时出现配置异常。

- 或 -

找不到配置中定义的默认个性化设置提供程序。

注解

此方法返回实例集合 UserPersonalizationStateInfo ,即每用户个性化设置状态信息,其中 pathToMatch 参数值与页面的路径匹配, usernameToMatch 匹配具有与该页面关联的个性化数据的用户名,并且用户被视为非活动状态。 换句话说,对于每个返回的 LastActivityDate 记录,用户的属性值小于或等于 userInactiveSinceDate。 集合仅 UserPersonalizationStateInfo 包含 实例。

此方法将参数通配符传递给基础个性化设置提供程序,因此数据存储如何处理这些字符取决于提供程序如何处理诸如星号 (*) 、百分比符号 (%) 或下划线 (_) 等字符。

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

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

使用默认个性化设置提供程序时, PersonalizationStateInfo将按字母顺序返回派生的对象,并按路径和用户名的组合按升序排序。 集合中对象的顺序由提供程序确定。

如果 userInactiveSinceDateMaxValue,则此方法返回的值等效于 FindUserState

pathToMatchusernameToMatch 都可以是 null。 参数 usernameToMatch 可以有逗号 (,) ,因为某些数据存储(如运行 Microsoft SQL Server 的数据存储)允许逗号作为通配符。

返回的数据受 pageIndexpageSize的约束,其中 pageIndex 控制要返回的记录和控制 pageSize 要返回的记录数。 例如,如果 pageIndex 设置为 0 且 pageSize 设置为 25,则返回的数据将是前 25 个条目。 如果 pageIndex 设置为 1 且 pageSize 设置为 25,则返回的数据将是条目 26 到 50。 参数 totalRecords 返回可用记录的总数。

另请参阅

适用于