PersonalizationAdministration.FindInactiveUserState 方法

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

参数

返回

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

例外

注解

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

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

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

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

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

如果 userInactiveSinceDate 为 MaxValue，则此方法返回的值等效于 FindUserState。

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

另请参阅

• WebPartPersonalization
• ASP.NET Web 部件控件
• Web 部件个性化概述
• 演练：使用用户控件实现 Web 部件个性化
• Web 部件个性化

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

参数

返回

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

例外

注解

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

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

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

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

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

如果 userInactiveSinceDate 为 MaxValue，则此方法返回的值等效于 FindUserState。

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

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

另请参阅

• WebPartPersonalization
• ASP.NET Web 部件控件
• Web 部件个性化概述
• 演练：使用用户控件实现 Web 部件个性化
• Web 部件个性化