ActiveDirectoryMembershipProvider.FindUsersByName Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Web.Security
Bütünleştirilmiş Kod:
System.Web.dll

Kullanıcı adına göre Active Directory veri deposundan bir kullanıcı koleksiyonu döndürür.

public:
 override System::Web::Security::MembershipUserCollection ^ FindUsersByName(System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public override System.Web.Security.MembershipUserCollection FindUsersByName (string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);
override this.FindUsersByName : string * int * int * int -> System.Web.Security.MembershipUserCollection
Public Overrides Function FindUsersByName (usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection

Parametreler

usernameToMatch
String

Aranacak kullanıcı adı veya kullanıcı adının bir bölümü.

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

Bu yöntem döndürdüğünde, koleksiyonda döndürülen toplam kayıt sayısını içerir. Bu parametre, başlatmadan iletilir.

Döndürülenler

MembershipUserCollection

MembershipUserCollection tarafından pageIndexbelirtilen sayfadan başlayan örnekleri içeren pageSizeMembershipUser bir.

Özel durumlar

InvalidOperationException

FindUsersByName(String, Int32, Int32, Int32) Yöntem, örnek başlatılmadan önce ActiveDirectoryMembershipProvider çağrılır.

ArgumentException

usernameToMatch boş veya kullanıcı adı için uzunluk üst sınırını (genellikle 256 karakter) aşıyor.

-veya-

usernameToMatch virgül içerir.

-veya-

pageIndex 0'dan küçüktür.

-Veya

pageSize 1'den küçüktür.

-veya-

pageSize, artı pageSize, eksi 1 ile pageIndexçarpılması Int32.MaxValue değerinden büyüktür.

ArgumentNullException

usernameToMatch, null değeridir.

NotSupportedException

EnableSearchMethods özelliğidirfalse.

Açıklamalar

yöntemi, FindUsersByName parametrelerle eşleşen userNameToMatch tüm kullanıcı adları için Active Directory veri deposundaki kullanıcı kayıtlarını içeren bir MembershipUserCollection örnek döndürür. Kayıtlar kullanıcı adına göre alfabetik olarak sıralanmış olarak döndürülür.

yöntemi tarafından FindUsersByName döndürülen sonuçlar ve pageSize parametreleriyle pageIndex kısıtlanır. parametresi içinde pageSize döndürülecek MembershipUserCollectionen fazla örnek sayısını MembershipUser belirtir. pageIndex parametresi döndürülecek sonuç sayfasını belirtir; burada 0 (sıfır) ilk sayfayı gösterir.

totalRecords parametresi, Active Directory veri deposunda bulunan eşleşen üyelik kullanıcılarının toplam sayısına ayarlanmış bir out parametredir. Örneğin, yapılandırılan veri deposu için 13 kullanıcı varsa ve pageIndex değer 5 ile 1 pageSize ise, MembershipUserCollection döndürülenler altıncı ile onuncu kullanıcıları içerir. totalRecords parametresi 13 olarak ayarlanır.

membership Öğesi (ASP.NET Ayarlar Şeması) öğesinin EnableSearchMethods özniteliğini kullanarak enableSearchMethods uygulamanın yapılandırma dosyasındaki özelliğini ayarlayarak kullanıcı aramaya izin verilip verilmeyeceğini denetleyebilirsiniz. özellik değerini false olarak EnableSearchMethods ayarlamak, yönteminin FindUsersByName özel NotSupportedException durum oluşturmasına neden olur.

Sağlayıcı, bağlantı dizesinde belirtilen arama noktasından başlayarak bir alt ağaç araması kullanır. ActiveDirectoryMembershipProvider Bağlantı dizeleri hakkında daha fazla bilgi için sınıf konusuna bakın.

Sınıf tarafından ActiveDirectoryMembershipProvider verilen arama sorgularının dizin sunucunuzun performansını olumsuz etkilemediğini onaylayana kadar üretim sistemlerinde aramayı etkinleştirmemenizi öneririz. ActiveDirectoryMembershipProvider sınıfı durum bilgisi olmayan bir Web ortamı için tasarlandığından, temel alınan System.DirectoryServices API'ler tarafından kullanıma sunulan disk belleği iyileştirmelerini kullanamaz. Bu, büyük dizinlere yönelik aramalar sırasındaki disk belleği işlemlerinin çok pahalı olduğu ve bundan kaçınılması gerektiği anlamına gelir. Arama işlemleri her zaman bağlantı dizesinde yapılandırılan dizin sunucusuna veya bir etki alanını işaret eden bir bağlantı dizesi söz konusu olduğunda otomatik olarak seçilen bir sunucuya verilir. Sağlayıcı, arama yöntemleri için genel katalog kullanmaz.

Şunlara uygulanır

Ayrıca bkz.