PersonalizationAdministration.FindInactiveUserState 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
基于指定参数为非活动用户返回每名用户个性化状态信息的集合。
重载
| 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.PersonalizationStateInfoCollectionPublic Shared Function FindInactiveUserState (pathToMatch As String, usernameToMatch As String, userInactiveSinceDate As DateTime) As PersonalizationStateInfoCollection参数
- pathToMatch
- String
要匹配的页面的路径。
- usernameToMatch
- String
要匹配的用户名，该用户名含有与相应页面关联的个性化设置数据。
- userInactiveSinceDate
- DateTime
上一次访问用户的个性化设置信息的日期。
返回
包含每名用户个性化状态信息的 PersonalizationStateInfoCollection。
例外
pathToMatch 或 usernameToMatch 在修整前或修整后是空字符串 ("")。
- 或 -
配置中定义的个性化设置提供程序的提供程序类型不正确。
- 或 -
任何参数的字符串长度超过 256 个字符。
注解
此方法返回实例集合 UserPersonalizationStateInfo ，即每用户个性化设置状态信息，其中 pathToMatch 参数值与页面的路径匹配， usernameToMatch 匹配具有与该页面关联的个性化数据的用户名，并且用户被视为非活动状态。 换句话说，对于每个返回的 LastActivityDate 记录，用户的属性值小于或等于 userInactiveSinceDate。 返回的集合仅 UserPersonalizationStateInfo 包含 实例。
此方法将查询通配符传递给基础数据存储。 对通配符的支持目前取决于每个提供程序如何处理字符，例如星号 (*) 、百分比符号 (%) 或下划线 (_) 。
通常，对于符合 SQL 的数据存储，可以对部分路径执行通配符搜索，其中通配符出现在 属性中 PathToMatch 搜索字符串文本的开头、结尾或中间。 例如，若要查找以“~/vdir”开头的所有路径，属性 PathToMatch 将设置为“~/vdir%”。
同样，对部分用户名的通配符搜索可以在属性的文本字符串 UsernameToMatch 中的任何点显示通配符。 例如，若要查找以“John”开头的所有用户名，属性 UsernameToMatch 将类似于“John%”。
使用默认个性化设置提供程序时， PersonalizationStateInfo将按字母顺序返回派生的对象，并按路径和用户名的组合按升序排序。 集合中对象的顺序由提供程序确定。
如果 userInactiveSinceDate 为 MaxValue，则此方法返回的值等效于 FindUserState。
pathToMatch和 usernameToMatch 都可以是 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.PersonalizationStateInfoCollectionPublic 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。
例外
pathToMatch 或 usernameToMatch 在修整前或修整后是空字符串 ("")。
- 或 -
pageIndex 小于零
- 或 -
pageSize 小于或等于零。
- 或 -
和 pageSize 的组合pageIndex超过了 Int32.MaxValue。
- 或 -
配置中定义的个性化设置提供程序的提供程序类型不正确。
- 或 -
任何参数的字符串长度超过 256 个字符。
注解
此方法返回实例集合 UserPersonalizationStateInfo ，即每用户个性化设置状态信息，其中 pathToMatch 参数值与页面的路径匹配， usernameToMatch 匹配具有与该页面关联的个性化数据的用户名，并且用户被视为非活动状态。 换句话说，对于每个返回的 LastActivityDate 记录，用户的属性值小于或等于 userInactiveSinceDate。 集合仅 UserPersonalizationStateInfo 包含 实例。
此方法将参数通配符传递给基础个性化设置提供程序，因此数据存储如何处理这些字符取决于提供程序如何处理诸如星号 (*) 、百分比符号 (%) 或下划线 (_) 等字符。
通常，对于符合 SQL 的数据存储，可以对部分路径执行通配符搜索，其中通配符出现在 属性中 PathToMatch 搜索字符串文本的开头、结尾或中间。 例如，若要查找以“~/vdir”开头的所有路径，属性 PathToMatch 将设置为“~/vdir%”。
同样，对部分用户名的通配符搜索可以在属性的文本字符串 UsernameToMatch 中的任何点显示通配符。 例如，若要查找以“John”开头的所有用户名，属性 UsernameToMatch 将类似于“John%”。
使用默认个性化设置提供程序时， PersonalizationStateInfo将按字母顺序返回派生的对象，并按路径和用户名的组合按升序排序。 集合中对象的顺序由提供程序确定。
如果 userInactiveSinceDate 为 MaxValue，则此方法返回的值等效于 FindUserState。
pathToMatch和 usernameToMatch 都可以是 null。 参数 usernameToMatch 可以有逗号 (，) ，因为某些数据存储（如运行 Microsoft SQL Server 的数据存储）允许逗号作为通配符。
返回的数据受 pageIndex 和 pageSize的约束，其中 pageIndex 控制要返回的记录和控制 pageSize 要返回的记录数。 例如，如果 pageIndex 设置为 0 且 pageSize 设置为 25，则返回的数据将是前 25 个条目。 如果 pageIndex 设置为 1 且 pageSize 设置为 25，则返回的数据将是条目 26 到 50。 参数 totalRecords 返回可用记录的总数。
