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 會指定只搜尋匿名配置檔、只有已驗證的配置檔或所有配置檔。 在搜尋的配置檔中，傳 LastActivityDate 回指定 userInactiveSinceDate 之參數值之前發生的任何配置檔。

如果您的數據源支援其他搜尋功能，例如通配符，您可以為用戶名稱提供更廣泛的搜尋功能。

傳 FindInactiveProfilesByUserName 回的結果會受到 pageIndex 和 pageSize 參數的限制。 參數pageSize會識別 中要傳ProfileInfoCollection回的物件ProfileInfo數目上限。 參數 pageIndex 會識別要傳回的結果頁面，其中零會識別第一頁。 參數totalRecords是參數out，根據 和 userInactiveSinceDate 參數，設定為applicationNameauthenticationOption所設定的非使用中使用者配置檔總數。 例如，如果已設定 applicationName的 有13位使用者，且 pageIndex 值為1 pageSize 且值為5，則傳回的 ProfileInfoCollection 會包含傳回的第六個到第十個非作用中配置檔。 參數 totalRecords 會設定為 13。

另請參閱

• 實作配置檔提供者
• ASP.NET 設定檔屬性概觀