MembershipProvider.FindUsersByName(String, Int32, Int32, Int32) Yöntem

Tanım

Kullanıcı adının eşleşecek belirtilen kullanıcı adını içerdiği üyelik kullanıcılarından oluşan bir koleksiyon alır.

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

Parametreler

usernameToMatch
String

Aranacak kullanıcı adı.

pageIndex
Int32

Döndürülecek sonuç sayfasının dizini. pageIndex sıfır tabanlıdır.

pageSize
Int32

Döndürülecek sonuç sayfasının boyutu.

totalRecords
Int32

Eşleşen kullanıcıların toplam sayısı.

Döndürülenler

MembershipUserCollection tarafından pageIndexbelirtilen sayfadan pageSizeMembershipUser başlayarak bir nesne sayfası içeren koleksiyon.

Örnekler

Uygulama örneği MembershipProvider için bkz. Profil Sağlayıcısı Uygulama.

Açıklamalar

FindUsersByName, kullanıcı adının yapılandırılan ApplicationName özellik için sağlanan usernameToMatch adla eşleştiği üyelik kullanıcılarının listesini döndürür. Veri kaynağınız joker karakterler gibi ek arama özelliklerini destekliyorsa, kullanıcı adları için daha kapsamlı arama özellikleri sağlayabilirsiniz.

tarafından FindUsersByName döndürülen sonuçlar ve pageSize parametreleriyle pageIndex kısıtlanır. parametresi koleksiyonda pageSizeMembershipUserCollection döndürülecek nesne sayısını MembershipUser tanımlar. pageIndex parametresi, döndürülecek sonuç sayfasını ve 0'ın ilk sayfayı tanımladığı sayfayı tanımlar. totalRecords parametresi, değerle eşleşen usernameToMatch üyelik kullanıcılarının toplam sayısına ayarlanmış bir out parametredir. Örneğin, kullanıcı adının bir bölümüyle veya tamamıyla eşleşen 13 kullanıcı bulunursa usernameToMatch ve pageIndex değer 5 ile pageSize 1 ise, MembershipUserCollection döndürülen altıncı ile onuncu kullanıcı arasında altıncıyı içerir. totalRecords 13 olarak ayarlanır.

Şunlara uygulanır

Ayrıca bkz.