MembershipProvider.FindUsersByName(String, Int32, Int32, Int32) 方法

定義

命名空間:

System.Web.Security

組件:

System.Web.ApplicationServices.dll

取得成員資格使用者的集合，其中的使用者名稱包含必須符合的特定使用者名稱。

public:
 abstract System::Web::Security::MembershipUserCollection ^ FindUsersByName(System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

public abstract System.Web.Security.MembershipUserCollection FindUsersByName (string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);

abstract member FindUsersByName : string * int * int * int -> System.Web.Security.MembershipUserCollection

Public MustOverride Function FindUsersByName (usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection

參數

usernameToMatch

String

要搜尋的使用者名稱。

pageIndex

Int32

要傳回的結果頁面索引。 pageIndex 以零為起始。

pageSize

Int32

要傳回的結果網頁大小。

totalRecords

Int32

相符的使用者總數。

傳回

MembershipUserCollection

包含一頁 pageSizeMembershipUser 物件的 MembershipUserCollection 集合，從 pageIndex 指定的頁面開始。

範例

如需實作的 MembershipProvider 範例，請參閱 實作配置檔提供者。

備註

FindUsersByName會傳回成員資格使用者的清單，其中用戶名稱符合為所設定ApplicationName屬性提供的 usernameToMatch 。 如果您的數據源支援其他搜尋功能，例如通配符，您可以為用戶名稱提供更廣泛的搜尋功能。

傳 FindUsersByName 回的結果會受到 pageIndex 和 pageSize 參數的限制。 參數pageSize會識別集合中MembershipUserCollection要傳回的物件數目MembershipUser。 參數 pageIndex 會識別要傳回的結果頁面，其中 0 會識別第一頁。 參數 totalRecords 是設定 out 為符合 usernameToMatch 值的成員資格用戶總數的參數。 例如，如果找到 usernameToMatch 符合部分或整個用戶名稱的13位使用者，且 pageIndex 值為1 pageSize 且值為5，則 MembershipUserCollection 會包含傳回的第六位到第十位使用者。 totalRecords 會設定為 13。

另請參閱

• 實作成員資格提供者
• ASP.NET 成員資格簡介