ProfileProvider.FindInactiveProfilesByUserName 方法

定义

命名空间:

System.Web.Profile

程序集:

System.Web.dll

在派生类中重写后，此方法检索最后一次活动在指定日期或指定日期之前发生并且用户名与指定用户名相匹配的配置文件的配置文件信息。

public:
 abstract System::Web::Profile::ProfileInfoCollection ^ FindInactiveProfilesByUserName(System::Web::Profile::ProfileAuthenticationOption authenticationOption, System::String ^ usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

public abstract System.Web.Profile.ProfileInfoCollection FindInactiveProfilesByUserName (System.Web.Profile.ProfileAuthenticationOption authenticationOption, string usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, out int totalRecords);

abstract member FindInactiveProfilesByUserName : System.Web.Profile.ProfileAuthenticationOption * string * DateTime * int * int * int -> System.Web.Profile.ProfileInfoCollection

Public MustOverride Function FindInactiveProfilesByUserName (authenticationOption As ProfileAuthenticationOption, usernameToMatch As String, userInactiveSinceDate As DateTime, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As ProfileInfoCollection

参数

authenticationOption

ProfileAuthenticationOption

ProfileAuthenticationOption 值之一，指定是返回匿名配置文件、经过身份验证的配置文件还是同时返回这两种类型的配置文件。

usernameToMatch

String

要搜索的用户名。

userInactiveSinceDate

DateTime

一个 DateTime，确定将哪些用户配置文件视为处于不活动状态。 如果用户配置文件的 LastActivityDate 值与此日期和时间相同，或在此日期和时间之前，则此配置文件被视为处于不活动状态。

pageIndex

Int32

要返回的结果页的索引。

pageSize

Int32

要返回的结果页的大小。

totalRecords

Int32

当此方法返回时，此参数包含配置文件的总数。

返回

ProfileInfoCollection

包含不活动配置文件的用户配置文件信息的 ProfileInfoCollection，这些不活动配置文件中的用户名与提供的 usernameToMatch 参数相匹配。

示例

下面的代码示例演示方法实现 FindInactiveProfilesByUserName 的方法签名。 有关完整 ProfileProvider 实现的示例，请参阅 如何：生成和运行配置文件提供程序示例。

public override ProfileInfoCollection FindInactiveProfilesByUserName(
    ProfileAuthenticationOption authenticationOption,
    string usernameToMatch,
    DateTime userInactiveSinceDate,
    int pageIndex,
    int pageSize,
    out int totalRecords)
{
    totalRecords = 0;

    return new ProfileInfoCollection();
}

Public Overrides Function FindInactiveProfilesByUserName( _
ByVal authenticationOption As ProfileAuthenticationOption, _
ByVal usernameToMatch As String, _
ByVal userInactiveSinceDate As DateTime, _
ByVal pageIndex As Integer, _
ByVal pageSize As Integer, _
 ByRef totalRecords As Integer) As ProfileInfoCollection

  totalRecords = 0

  Return New ProfileInfoCollection()
End Function

注解

方法 FindInactiveProfilesByUserName 用于检索用户名与所提供的 usernameToMatch 参数匹配的配置文件的未使用用户配置文件的配置文件信息。 applicationName仅返回配置文件中指定的 的数据。 参数 authenticationOption 指定是只搜索匿名配置文件、仅经过身份验证的配置文件还是搜索所有配置文件。 在搜索的配置文件中，返回指定userInactiveSinceDate参数值上或之前发生的任何配置文件LastActivityDate。

如果数据源支持其他搜索功能（如通配符），则可以为用户名提供更广泛的搜索功能。

返回 FindInactiveProfilesByUserName 的结果受 pageIndex 和 pageSize 参数的约束。 参数pageSize标识在 中ProfileInfoCollection返回的最大对象数ProfileInfo。 参数 pageIndex 标识要返回的结果页，其中 0 表示第一页。 参数totalRecords是一个out参数，它根据 authenticationOption 和 userInactiveSinceDate 参数设置为配置的 applicationName非活动用户配置文件总数。 例如，如果配置的 applicationName有 13 个用户，并且 pageIndex 值为 1，值为 pageSize 5， ProfileInfoCollection 则返回的 将包含返回的第六个到第十个非活动配置文件。 参数 totalRecords 将设置为 13。

另请参阅

• 实现配置文件提供程序
• ASP.NET 配置文件属性概述