Freigeben über


DirectorySearcher Klasse

Definition

Führt Abfragen in Active Directory-Domänendiensten durch.

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
Vererbung
DirectorySearcher
Attribute

Hinweise

Verwenden Sie ein DirectorySearcher -Objekt zum Durchsuchen und Ausführen von Abfragen für eine Active Directory Domain Services-Hierarchie mithilfe des Lightweight Directory Access Protocol (LDAP). LDAP ist der einzige vom System bereitgestellte ADSI-Anbieter (Active Directory Service Interfaces), der die Verzeichnissuche unterstützt. Ein Administrator kann Objekte erstellen, ändern und löschen, die sich in der Hierarchie befinden. Weitere Informationen finden Sie unter Verwenden von System.DirectoryServices.

Wenn Sie eine Instanz von DirectorySearchererstellen, geben Sie den Stamm an, den Sie abrufen möchten, sowie eine optionale Liste der abzurufenden Eigenschaften. Mit SearchRoot der -Eigenschaft können Sie zusätzliche Eigenschaften festlegen, um die folgenden Aufgaben auszuführen:

  • Speichern Sie die Suchergebnisse auf dem lokalen Computer zwischen. Legen Sie die CacheResults -Eigenschaft auf fest true , um Verzeichnisinformationen auf dem lokalen Computer zu speichern. Updates für diesen lokalen Cache werden nur dann an Active Directory Domain Services committet, wenn die DirectoryEntry.CommitChanges -Methode aufgerufen wird.

  • Geben Sie die Dauer der Suche mithilfe der -Eigenschaft an ServerTimeLimit .

  • Rufen Sie nur Attributnamen ab. Legen Sie die PropertyNamesOnly -Eigenschaft auf fest true , um nur die Namen der Attribute abzurufen, denen Werte zugewiesen wurden.

  • Führen Sie eine Auslagerungssuche aus. Legen Sie die PageSize -Eigenschaft fest, um die maximale Anzahl von Objekten anzugeben, die in einer ausgelagerten Suche zurückgegeben werden. Wenn Sie keine Auslagerungssuche durchführen möchten, legen Sie die PageSize -Eigenschaft auf den Standardwert 0 (null) fest.

  • Geben Sie mithilfe der -Eigenschaft die maximale Anzahl von zurückzugebenden Einträgen an SizeLimit . Wenn Sie die SizeLimit -Eigenschaft auf den Standardwert 0 (null) festlegen, ist der vom Server festgelegte Standardwert 1000 Einträge.

Hinweis

Wenn die maximale Anzahl zurückgegebener Einträge und Zeitlimits die auf dem Server festgelegten Einschränkungen überschreitet, setzen die Servereinstellungen die Komponenteneinstellungen außer Kraft.

Eine Liste der anfänglichen Eigenschaftenwerte für eine Instanz der DirectorySearcher-Klasse finden Sie im DirectorySearcher()-Konstruktor.

Hinweis

Es wird davon ausgegangen, dass Sie über allgemeine Kenntnisse der Active Directory Domain Services verfügen, bevor Sie diese Klasse verwenden. Weitere Informationen finden Sie in der System.DirectoryServices Übersicht.

Konstruktoren

DirectorySearcher()

Initialisiert eine neue Instanz der DirectorySearcher-Klasse mit Standardwerten.

DirectorySearcher(DirectoryEntry)

Initialisiert eine neue Instanz der DirectorySearcher-Klasse unter Verwendung der angegebenen Stammsuche.

DirectorySearcher(DirectoryEntry, String)

Initialisiert eine neue Instanz der DirectorySearcher-Klasse mit der angegebenen Stammsuche und dem angegebenen Suchfilter.

DirectorySearcher(DirectoryEntry, String, String[])

Initialisiert eine neue Instanz der DirectorySearcher-Klasse mit der angegebenen Stammsuche, dem angegebenen Suchfilter und den abzurufenden Eigenschaften.

DirectorySearcher(DirectoryEntry, String, String[], SearchScope)

Initialisiert eine neue Instanz der DirectorySearcher-Klasse mit der angegebenen Stammsuche, dem angegebenen Suchfilter, den abzurufenden Eigenschaften und dem Suchbereich.

DirectorySearcher(String)

Initialisiert eine neue Instanz der DirectorySearcher-Klasse mit dem angegebenen Suchfilter.

DirectorySearcher(String, String[])

Initialisiert eine neue Instanz der DirectorySearcher-Klasse mit dem angegebenen Suchfilter und den abzurufenden Eigenschaften.

DirectorySearcher(String, String[], SearchScope)

Initialisiert eine neue Instanz der DirectorySearcher-Klasse mit dem angegebenen Suchfilter, den abzurufenden Eigenschaften und dem Suchbereich.

Eigenschaften

Asynchronous

Ruft einen Wert ab, der angibt, ob die Suche asynchron ausgeführt wird, oder legt diesen fest.

AttributeScopeQuery

Ruft den LDAP-Anzeigenamen des Attributs für den Distinguished Name auf, in dem gesucht werden soll, oder legt diesen fest. Für diesen Suchtyp kann nur ein Attribut verwendet werden.

CacheResults

Ruft einen Wert ab, der angibt, ob das Ergebnis im Cache des Clientcomputers gespeichert wird, oder legt diesen fest.

CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.

(Geerbt von Component)
ClientTimeout

Ruft die Höchstdauer ab, die der Client auf die Rückgabe von Ergebnissen durch den Server wartet, oder legt diese fest. Wenn der Server nicht innerhalb dieser Zeitspanne antwortet, wird die Suche ohne Rückgabe von Ergebnissen abgebrochen.

Container

Ruft die IContainer ab, die in der Component enthalten ist.

(Geerbt von Component)
DerefAlias

Ruft einen Wert ab, der angibt, wie die Aliase von Objekten, die bei einer Suche gefunden wurden, aufgelöst werden sollen, oder legt diesen fest.

DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.

(Geerbt von Component)
DirectorySynchronization

Ruft ein Objekt ab, welches das bei der Suche zu verwendende Verzeichnissynchronisierungs-Steuerelement darstellt, oder legt dieses fest.

Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.

(Geerbt von Component)
ExtendedDN

Ruft einen Wert ab, der das Format der Distinguished Names angibt, oder legt diesen fest.

Filter

Ruft einen Wert ab, der das Format der Filterzeichenfolge für LDAP (Lightweight Directory Access Protocol) angibt, oder legt diesen fest.

PageSize

Ruft einen Wert ab, der die Seitengröße für eine ausgelagerte Suche angibt, oder legt diesen fest.

PropertiesToLoad

Ruft einen Wert ab, der die Liste der während des Suchvorgangs abzurufenden Eigenschaften angibt.

PropertyNamesOnly

Ruft einen Wert ab, der angibt, ob die Suche nur die Namen der Attribute abruft, denen Werte zugewiesen sind, oder legt diesen fest.

ReferralChasing

Ruft einen Wert ab, der angibt, wie Referenzen ausgewertet werden, oder legt diesen fest.

SearchRoot

Ruft einen Wert ab, der den Knoten in der Active Directory-Domänendienste-Hierarchie angibt, bei dem die Suche beginnt, oder legt diesen fest.

SearchScope

Ruft einen Wert für den vom Server überwachten Suchbereich ab oder legt diesen fest.

SecurityMasks

Ruft einen Wert ab, der angibt, welche Sicherheitszugriffsinformationen für die angegebenen Attribute von der Suche zurückgegeben werden sollen, oder legt diesen Wert fest.

ServerPageTimeLimit

Ruft einen Wert ab, der die maximale Zeitdauer angibt, die der Server nach einer einzelnen Seite mit Ergebnissen suchen soll, oder legt diesen Wert fest. Dies ist jedoch nicht mit der Zeitbegrenzung für den gesamten Suchvorgang gleichzusetzen.

ServerTimeLimit

Die ServerTimeLimit-Eigenschaft ruft einen Wert ab, der die maximale Zeitdauer angibt, die der Server für die Suche aufwenden soll, oder legt diesen fest. Bei Erreichen der Zeitbegrenzung werden nur die bis zu diesem Zeitpunkt gefundenen Einträge zurückgegeben.

Site

Ruft den ISite von Component ab oder legt ihn fest.

(Geerbt von Component)
SizeLimit

Ruft einen Wert ab, der die vom Server in einer Suche zurückgegebene maximale Anzahl von Objekten angibt, oder legt diesen fest.

Sort

Ruft einen Wert ab, der die Eigenschaft angibt, nach der die Ergebnisse sortiert werden, oder legt diesen fest.

Tombstone

Ruft einen Wert ab, der angibt, ob bei der Suche auch gelöschte Objekte, die mit den Suchfilterkriterien übereinstimmen, zurückgegeben werden sollen, oder legt diesen Wert fest.

VirtualListView

Ruft einen Wert ab, der die Suchoptionen für virtuelle Listenansichten angibt, oder legt diesen fest.

Methoden

CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.

(Geerbt von MarshalByRefObject)
Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.

(Geerbt von Component)
Dispose(Boolean)

Gibt die vom DirectorySearcher-Objekt verwendeten verwalteten Ressourcen und optional die nicht verwalteten Ressourcen frei.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
FindAll()

Führt die Suche aus und gibt eine Auflistung der gefundenen Einträge zurück.

FindOne()

Führt die Suche aus und gibt nur den ersten gefundenen Eintrag zurück.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetLifetimeService()
Veraltet.

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.

(Geerbt von MarshalByRefObject)
GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.

(Geerbt von Component)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.

(Geerbt von MarshalByRefObject)
ToString()

Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden). Diese Methode darf nicht überschrieben werden.

(Geerbt von Component)

Ereignisse

Disposed

Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird.

(Geerbt von Component)

Gilt für:

Weitere Informationen