SimpleMembershipProvider.FindUsersByEmail 方法

傳回電子郵件地址符合指定之電子郵件地址的所有使用者帳戶。

命名空間:  WebMatrix.WebData
組件:  WebMatrix.WebData (在 WebMatrix.WebData.dll 中)

public override MembershipUserCollection FindUsersByEmail(
	string emailToMatch,
	int pageIndex,
	int pageSize,
	out int totalRecords
)

參數

emailToMatch
型別:System.String

要搜尋的電子郵件地址。

pageIndex
型別:System.Int32

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

pageSize
型別:System.Int32

要傳回的結果頁面大小。

totalRecords
型別:System.Int32%

當這個方法傳回時,包含相符使用者帳戶的總數。

傳回值

型別:System.Web.Security.MembershipUserCollection
包含一頁 pageSize 使用者帳戶 (從 pageIndex 指定的頁面開始) 的集合。

這個方法會在邏輯頁面中傳回結果。這樣可讓您以可管理的區塊傳回使用者資訊。例如,若您的應用程式目前有 2000 個使用者帳戶,您一次可以傳回 200 頁 (每頁包含 10 個使用者)。

pageIndexpageSize 參數會定義要傳回的特定頁面。totalRecords 參數是輸出參數,已設定為符合 emailToMatch 值的成員資格使用者總數。例如,若找到 13 個使用者,而且 pageIndex 值為 1 及 pageSize 為 5,則 MembershipUserCollection 物件包含傳回的第 6 到第 10 位使用者,且 totalRecords 設定為 13。

附註附註

如果已透過呼叫 WebSecurity.InitializeDatabaseConnection() 方法初始化 SimpleMembershipProvider 類別,則不支援此方法並將擲回 NotSupportedException 例外狀況。但是,若尚未呼叫 WebSecurity.InitializeDatabaseConnection() 方法,而且您已將自己的站台設定為使用標準 ASP.NET 成員資格提供者,這個方法就會傳遞給標準成員資格提供者。如需詳細資訊,請參閱 SimpleMembershipProvider 類別概觀。

顯示: