ActiveDirectoryMembershipProvider.GetAllUsers(Int32, Int32, Int32) Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Bir Active Directory veri kaynağında depolanan tüm kullanıcıların koleksiyonunu alır.
public:
override System::Web::Security::MembershipUserCollection ^ GetAllUsers(int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);public override System.Web.Security.MembershipUserCollection GetAllUsers (int pageIndex, int pageSize, out int totalRecords);override this.GetAllUsers : int * int * int -> System.Web.Security.MembershipUserCollectionPublic Overrides Function GetAllUsers (pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollectionParametreler
- 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 tarafından pageIndexbelirtilen sayfadan başlayan örnekleri içeren pageSizeMembershipUser bir.
Özel durumlar
GetAllUsers(Int32, Int32, Int32) Yöntem, örnek başlatılmadan önce ActiveDirectoryMembershipProvider çağrılır.
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.
EnableSearchMethods özelliğidirfalse.
Açıklamalar
Bu yöntem, ASP.NET uygulamasının yapılandırma dosyasında belirtilen Active Directory veri deposundan kullanıcı bilgilerini almak için sınıfı tarafından Membership çağrılır.
yöntemi tarafından GetAllUsers döndürülen sonuçlar ve pageSize parametreleriyle pageIndex kısıtlanır. parametresi koleksiyonda pageSizeMembershipUserCollection döndürülecek en 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 1 pageSize ile 5 arasındaysa, 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ği ayarlayarak kullanıcıların aranmasına izin verilip verilmeyeceğini denetleyebilirsiniz. özelliğinin EnableSearchMethods olarak false ayarlanması, yönteminin GetAllUsers ö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.
