ActiveDirectoryMembershipProvider.FindUsersByEmail Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zwraca kolekcję użytkowników członkostwa z magazynu danych usługi Active Directory na podstawie adresu e-mail użytkownika.
public:
override System::Web::Security::MembershipUserCollection ^ FindUsersByEmail(System::String ^ emailToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public override System.Web.Security.MembershipUserCollection FindUsersByEmail (string emailToMatch, int pageIndex, int pageSize, out int totalRecords);
override this.FindUsersByEmail : string * int * int * int -> System.Web.Security.MembershipUserCollection
Public Overrides Function FindUsersByEmail (emailToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As MembershipUserCollection
Parametry
- emailToMatch
- String
Email adres lub część adresu e-mail do wyszukania.
- pageIndex
- Int32
Indeks strony wyników do zwrócenia. Funkcja pageIndex
rozpoczyna liczenie od zera.
- pageSize
- Int32
Rozmiar strony wyników do zwrócenia.
- totalRecords
- Int32
Gdy ta metoda zostanie zwrócona, zawiera łączną liczbę użytkowników zwróconych w kolekcji. Ten parametr jest przekazywany jako niezainicjowany.
Zwraca
Element MembershipUserCollection zawierający wystąpienia rozpoczynające pageSize
MembershipUser się na stronie określonej przez pageIndex
.
Wyjątki
Metoda jest wywoływana FindUsersByEmail(String, Int32, Int32, Int32) przed zainicjowanym wystąpieniem ActiveDirectoryMembershipProvider .
emailToMatch
jest pusty.
-lub-
emailToMatch
przekracza 256 znaków.
-lub-
pageIndex
wartość jest mniejsza niż 0.
-lub-
pageSize
wartość jest mniejsza niż 1.
-lub-
pageSize
pomnożony przez wartość pageIndex
, plus pageSize
, minus 1 jest większy niż Int32.MaxValue.
Właściwość EnableSearchMethods to false
.
Uwagi
Metoda FindUsersByEmail pobiera MembershipUserCollection rekordy użytkownika z magazynu usługi Active Directory zgodnego z emailToMatch
parametrami. Rekordy użytkownika są zwracane posortowane w kolejności rosnącej według adresu e-mail.
Parametr emailToMatch
jest ograniczony do 256 znaków.
Klasa ActiveDirectoryMembershipProvider będzie wystawiać wyszukiwanie przy użyciu clientSearchTimeout
wartości konfiguracji i serverSearchTimeout
. ActiveDirectoryMembershipProvider Ponieważ klasa wykonuje wyszukiwania na serwerze katalogów przy użyciu stron z 512 wierszami na stronę, limity czasu dotyczą każdej strony wyników pobranych przez klasęActiveDirectoryMembershipProvider. Jeśli na przykład zapytanie wyszukiwania spowoduje wyświetlenie 1000 wierszy danych, ActiveDirectoryMembershipProvider klasa pobierze te informacje jako dwie strony danych. Oznacza to, że limity czasu klienta i wyszukiwania zaczną liczyć od zera, gdy ActiveDirectoryMembershipProvider klasa żąda drugiej strony danych.
Wyniki zwracane przez metodę FindUsersByEmail są ograniczone przez pageIndex
parametry i pageSize
. Parametr pageSize
określa maksymalną liczbę MembershipUser wystąpień, które mają być zwracane w obiekcie MembershipUserCollection. Parametr pageIndex
określa, która strona wyników ma być zwracana, gdzie wartość 0 (zero) wskazuje pierwszą stronę.
Parametr totalRecords
jest parametrem ustawionym out
na całkowitą liczbę pasujących użytkowników członkostwa znalezionych w magazynie danych usługi Active Directory. Jeśli na przykład dla skonfigurowanego magazynu danych istnieje 13 użytkowników, a pageIndex
wartość wynosi 1 z pageSize
5, MembershipUserCollection zwrócona wartość będzie zawierać szósty do dziesięciu użytkowników. Parametr totalRecords
zostanie ustawiony na wartość 13.
Możesz kontrolować, czy zezwolić na wyszukiwanie użytkowników, ustawiając EnableSearchMethods właściwość w pliku konfiguracji aplikacji przy użyciu enableSearchMethods
atrybutu elementu członkostwa (ASP.NET Settings Schema). EnableSearchMethods Ustawienie właściwości powoduje, że false
FindUsersByEmail metoda zgłasza NotSupportedException wyjątek.
Dostawca używa wyszukiwania poddrzewa rozpoczynającego się od punktu wyszukiwania określonego w parametrach połączenia. Zobacz temat klasy, ActiveDirectoryMembershipProvider aby uzyskać więcej informacji na temat parametrów połączenia.
Zalecamy, aby nie włączać wyszukiwania w systemach produkcyjnych, dopóki nie potwierdzisz, że zapytania wyszukiwania wydane przez ActiveDirectoryMembershipProvider klasę nie wpływają negatywnie na wydajność serwera katalogów. ActiveDirectoryMembershipProvider Ponieważ klasa jest przeznaczona dla bezstanowego środowiska sieci Web, nie może korzystać z optymalizacji stronicowania uwidocznionych przez bazowe System.DirectoryServices interfejsy API. Oznacza to, że operacje stronicowania podczas wyszukiwania w dużych katalogach są bardzo kosztowne i należy unikać. Operacje wyszukiwania są zawsze wystawiane względem serwera katalogów skonfigurowanego w parametrach połączenia lub automatycznie wybranego serwera w przypadku parametrów połączenia wskazujących domenę. Dostawca nie używa wykazu globalnego dla swoich metod wyszukiwania.
Dotyczy
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla