DirectorySearcher Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.DirectoryServices

Zestaw:: System.DirectoryServices.dll

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.

Wykonuje zapytania względem Active Directory Domain Services.

public ref class DirectorySearcher : System::ComponentModel::Component

public class DirectorySearcher : System.ComponentModel.Component

[System.DirectoryServices.DSDescription("DirectorySearcherDesc")]
public class DirectorySearcher : System.ComponentModel.Component

type DirectorySearcher = class
    inherit Component

[<System.DirectoryServices.DSDescription("DirectorySearcherDesc")>]
type DirectorySearcher = class
    inherit Component

Public Class DirectorySearcher
Inherits Component

Dziedziczenie: Object

MarshalByRefObject

Component
DirectorySearcher

Atrybuty: DSDescriptionAttribute

Uwagi

DirectorySearcher Użyj obiektu do wyszukiwania i wykonywania zapytań względem hierarchii Active Directory Domain Services przy użyciu protokołu LDAP (Lightweight Directory Access Protocol). LDAP jest jedynym dostawcą interfejsów usługi Active Directory (ADSI), który obsługuje wyszukiwanie katalogów. Administrator może tworzyć, zmieniać i usuwać obiekty znalezione w hierarchii. Aby uzyskać więcej informacji, zobacz Using System.DirectoryServices (Używanie usługi System.DirectoryServices).

Podczas tworzenia wystąpienia DirectorySearcherprogramu należy określić katalog główny, który chcesz pobrać, oraz opcjonalną listę właściwości do pobrania. Właściwość SearchRoot umożliwia ustawienie dodatkowych właściwości w celu wykonania następujących zadań:

Buforuj wyniki wyszukiwania na komputerze lokalnym. CacheResults Ustaw właściwość na wartość , aby przechowywać true informacje o katalogu na komputerze lokalnym. Aktualizacje są wykonywane w tej lokalnej pamięci podręcznej i zatwierdzone do Active Directory Domain Services tylko wtedy, gdy metoda jest wywoływanaDirectoryEntry.CommitChanges.
Określ czas wyszukiwania przy użyciu ServerTimeLimit właściwości .
Pobierz tylko nazwy atrybutów. PropertyNamesOnly Ustaw właściwość , aby pobrać true tylko nazwy atrybutów, do których przypisano wartości.
Wykonaj wyszukiwanie stronicowane. PageSize Ustaw właściwość, aby określić maksymalną liczbę obiektów zwracanych w wyszukiwaniu stronicowanym. Jeśli nie chcesz wykonywać stronicowanego wyszukiwania, ustaw PageSize właściwość na wartość domyślną zero.
Określ maksymalną liczbę wpisów do zwrócenia przy użyciu SizeLimit właściwości . Jeśli właściwość zostanie ustawiona SizeLimit na wartość domyślną zero, wartość domyślna określona przez serwer to 1000 wpisów.

Uwaga

Jeśli maksymalna liczba zwracanych wpisów i limitów czasu przekracza ograniczenia ustawione na serwerze, ustawienia serwera zastępują ustawienia składnika.

Aby uzyskać listę początkowych wartości właściwości dla wystąpienia DirectorySearcher klasy, zobacz DirectorySearcher() konstruktor.

Uwaga

Przyjęto założenie, że masz ogólną wiedzę na temat Active Directory Domain Services przed użyciem tej klasy. Aby uzyskać więcej informacji, zobacz System.DirectoryServices omówienie.

Konstruktory

DirectorySearcher()	Inicjuje nowe wystąpienie klasy DirectorySearcher z domyślnymi wartościami.
DirectorySearcher(DirectoryEntry)	Inicjuje DirectorySearcher nowe wystąpienie klasy przy użyciu określonego katalogu głównego wyszukiwania.
DirectorySearcher(DirectoryEntry, String)	Inicjuje DirectorySearcher nowe wystąpienie klasy przy użyciu określonego katalogu głównego wyszukiwania i filtru wyszukiwania.
DirectorySearcher(DirectoryEntry, String, String[])	Inicjuje nowe wystąpienie klasy przy użyciu określonego DirectorySearcher katalogu głównego wyszukiwania, filtru wyszukiwania i właściwości do pobrania.
DirectorySearcher(DirectoryEntry, String, String[], SearchScope)	Inicjuje nowe wystąpienie klasy przy użyciu określonego DirectorySearcher katalogu głównego wyszukiwania, filtru wyszukiwania, właściwości do pobrania i zakresu wyszukiwania.
DirectorySearcher(String)	Inicjuje DirectorySearcher nowe wystąpienie klasy przy użyciu określonego filtru wyszukiwania.
DirectorySearcher(String, String[])	Inicjuje DirectorySearcher nowe wystąpienie klasy przy użyciu określonego filtru wyszukiwania i właściwości do pobrania.
DirectorySearcher(String, String[], SearchScope)	Inicjuje nowe wystąpienie klasy przy użyciu określonego DirectorySearcher filtru wyszukiwania, właściwości do pobrania i zakresu wyszukiwania.

Właściwości

Asynchronous	Pobiera lub ustawia wartość wskazującą, czy wyszukiwanie jest wykonywane asynchronicznie.
AttributeScopeQuery	Pobiera lub ustawia nazwę wyświetlaną LDAP atrybutu nazwy wyróżniającej do wyszukania. Dla tego typu wyszukiwania można użyć tylko jednego atrybutu.
CacheResults	Pobiera lub ustawia wartość wskazującą, czy wynik jest buforowany na komputerze klienckim.
CanRaiseEvents	Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
ClientTimeout	Pobiera lub ustawia maksymalny czas oczekiwania klienta na zwrócenie wyników przez serwer. Jeśli serwer nie odpowie w tym czasie, wyszukiwanie zostanie przerwane i nie zostaną zwrócone żadne wyniki.
Container	Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
DerefAlias	Pobiera lub ustawia wartość wskazującą sposób rozpoznawania aliasów obiektów znalezionych podczas wyszukiwania.
DesignMode	Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
DirectorySynchronization	Pobiera lub ustawia obiekt reprezentujący kontrolkę synchronizacji katalogów do użycia z wyszukiwaniem.
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component)
ExtendedDN	Pobiera lub ustawia wartość wskazującą format nazw wyróżniających.
Filter	Pobiera lub ustawia wartość wskazującą ciąg filtru w formacie Lightweight Directory Access Protocol (LDAP).
PageSize	Pobiera lub ustawia wartość wskazującą rozmiar strony w wyszukiwaniu stronicowanym.
PropertiesToLoad	Pobiera wartość wskazującą listę właściwości do pobrania podczas wyszukiwania.
PropertyNamesOnly	Pobiera lub ustawia wartość wskazującą, czy wyszukiwanie pobiera tylko nazwy atrybutów, do których zostały przypisane wartości.
ReferralChasing	Pobiera lub ustawia wartość wskazującą, w jaki sposób polecenia są ścigane.
SearchRoot	Pobiera lub ustawia wartość wskazującą węzeł w hierarchii Active Directory Domain Services, w której rozpoczyna się wyszukiwanie.
SearchScope	Pobiera lub ustawia wartość wskazującą zakres wyszukiwania obserwowanego przez serwer.
SecurityMasks	Pobiera lub ustawia wartość wskazującą, które informacje o dostępie do zabezpieczeń dla określonych atrybutów powinny być zwracane przez wyszukiwanie.
ServerPageTimeLimit	Pobiera lub ustawia wartość wskazującą maksymalny czas wyszukiwania przez serwer pojedynczej strony wyników. Nie jest to takie samo, jak limit czasu dla całego wyszukiwania.
ServerTimeLimit	Właściwość ServerTimeLimit pobiera lub ustawia wartość wskazującą maksymalny czas spędzony na wyszukiwaniu serwera. Jeśli limit czasu zostanie osiągnięty, zwracane są tylko wpisy znalezione do tego punktu.
Site	Pobiera lub ustawia ISite element .Component (Odziedziczone po Component)
SizeLimit	Pobiera lub ustawia wartość wskazującą maksymalną liczbę obiektów zwracanych przez serwer w wyszukiwaniu.
Sort	Pobiera lub ustawia wartość wskazującą właściwość, na której są sortowane wyniki.
Tombstone	Pobiera lub ustawia wartość wskazującą, czy wyszukiwanie powinno również zwracać usunięte obiekty zgodne z filtrem wyszukiwania.
VirtualListView	Pobiera lub ustawia wartość wskazującą opcje widoku listy wirtualnej dla wyszukiwania.

Metody

CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component)
Dispose(Boolean)	Zwalnia zarządzane zasoby, które są używane przez DirectorySearcher obiekt, a opcjonalnie zwalnia niezarządzane zasoby.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
FindAll()	Wykonuje wyszukiwanie i zwraca kolekcję znalezionych wpisów.
FindOne()	Wykonuje wyszukiwanie i zwraca tylko pierwszy znaleziony wpis.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Nieaktualne. Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetService(Type)	Zwraca obiekt reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container. (Odziedziczone po Component)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
InitializeLifetimeService()	Nieaktualne. Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
ToString()	Zwraca wartość String zawierającą nazwę Componentobiektu , jeśli istnieje. Ta metoda nie powinna być zastępowana. (Odziedziczone po Component)

Zdarzenia

Disposed

Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody .

(Odziedziczone po Component)

Dotyczy