DirectorySearcher Klasse

Referenz

Definition

Namespace:: System.DirectoryServices

Assembly:: System.DirectoryServices.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: Object

MarshalByRefObject

Component
DirectorySearcher

Attribute: DSDescriptionAttribute

Hinweise

Verwenden Sie ein Objekt, um Abfragen mit einer Active Directory Domain Services Hierarchie mithilfe des DirectorySearcher Lightweight Directory Access Protocol (LDAP) zu durchsuchen und auszuführen. LDAP ist der einzige systemspezifische Active Directory-Dienstschnittstellenanbieter (ADSI), der die Verzeichnissuche unterstützt. Ein Administrator kann Objekte vornehmen, ändern und löschen, die in der Hierarchie gefunden werden. Weitere Informationen finden Sie unter Verwenden von System.DirectoryServices.

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

Cachen Sie die Suchergebnisse auf dem lokalen Computer. Legen Sie die CacheResults Eigenschaft fest, true um Verzeichnisinformationen auf dem lokalen Computer zu speichern. Aktualisierungen werden an diesen lokalen Cache vorgenommen und Active Directory Domain Services nur dann verpflichtet, wenn die DirectoryEntry.CommitChanges Methode aufgerufen wird.
Geben Sie die Dauer der Suche mithilfe der ServerTimeLimit Eigenschaft an.
Rufen Sie nur Attributnamen ab. Legen Sie die PropertyNamesOnly Eigenschaft fest, true um nur die Namen von Attributen abzurufen, denen Werte zugewiesen wurden.
Führen Sie eine Seitensuche aus. Legen Sie die PageSize Eigenschaft fest, um die maximale Anzahl von Objekten anzugeben, die in einer Seitensuche zurückgegeben werden. Wenn Sie keine Seitensuche ausführen möchten, legen Sie die PageSize Eigenschaft auf den Standardwert von Null fest.
Geben Sie die maximale Anzahl der zurückgegebenen Einträge an, indem Sie die SizeLimit Eigenschaft verwenden. Wenn Sie die Eigenschaft auf die Standardeinstellung null festlegen, ist die SizeLimit serverbestimmte Standardeinstellung 1000 Einträge.

Hinweis

Wenn die maximale Anzahl zurückgegebener Einträge und Zeitlimits die Einschränkungen überschreiten, die auf dem Server festgelegt sind, überschreiben die Servereinstellungen die Komponenteneinstellungen.

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 ein allgemeines Verständnis von Active Directory Domain Services haben, 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