ProfileProvider.FindProfilesByUserName 方法

定義

命名空間:

System.Web.Profile

組件:

System.Web.dll

在衍生類別中覆寫時，會擷取使用者名稱符合指定使用者名稱之設定檔的設定檔資訊。

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

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

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

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

參數

authenticationOption

ProfileAuthenticationOption

ProfileAuthenticationOption 的其中一個值，指定是否要傳回匿名、已驗證或是這兩種類型的設定檔。

usernameToMatch

String

要搜尋的使用者名稱。

pageIndex

Int32

要傳回的結果頁面索引。

pageSize

Int32

要傳回的結果網頁大小。

totalRecords

Int32

當方法回傳時，包含設定檔的總數。

傳回

ProfileInfoCollection

ProfileInfoCollection，包含設定檔的使用者設定檔資訊，其中使用者名稱符合所提供的 usernameToMatch 參數。

範例

下列程式代碼範例顯示 方法實作的方法 FindProfilesByUserName 簽章。 如需完整 ProfileProvider 實作的範例，請參閱 如何：建置和執行配置檔提供者範例。

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

    return new ProfileInfoCollection();
}

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

  totalRecords = 0

  Return New ProfileInfoCollection()
End Function

備註

方法 FindProfilesByUserName 會傳回配置檔的配置檔資訊清單，其中用戶名稱符合所提供的 usernameToMatch 參數。 只會傳回組態檔中指定的 數據 applicationName 。 參數 authenticationOption 會指定只搜尋匿名配置檔、僅限已驗證的配置檔或所有配置檔。

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

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

另請參閱

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