DirectorySearcher Klasa

Definicja

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
DirectorySearcher
Atrybuty

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ą wprowadzane do tej lokalnej pamięci podręcznej i zatwierdzane w 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

Zobacz też