DirectorySearcher-Klasse

Führt Abfragen in Active Directory durch.

Namespace: System.DirectoryServices
Assembly: System.DirectoryServices (in system.directoryservices.dll)

Syntax

'Declaration
Public Class DirectorySearcher
    Inherits Component
'Usage
Dim instance As DirectorySearcher

public class DirectorySearcher : Component

public ref class DirectorySearcher : public Component

public class DirectorySearcher extends Component

public class DirectorySearcher extends Component

Hinweise

Verwenden Sie ein DirectorySearcher-Objekt, um Abfragen in einer Active Directory-Hierarchie mithilfe von LDAP (Lightweight Directory Access Protocol) zu suchen und durchzuführen. LDAP ist der einzige vom System gelieferte ADSI-Provider (Active Directory Service Interfaces), der das Durchsuchen von Verzeichnissen unterstützt. Ein Administrator kann in der Hierarchie befindliche Objekte erstellen, ändern oder löschen. Weitere Informationen finden Sie unter Verwenden von System.DirectoryServices.

Wenn Sie eine Instanz von DirectorySearcher erstellen, geben Sie das abzurufende Stammverzeichnis und eine optionale Liste abzurufender Eigenschaften an. Mit der SearchRoot-Eigenschaft können Sie zusätzliche Eigenschaften festlegen, um die folgenden Aufgaben auszuführen:

• Führen Sie eine Zwischenspeicherung der Suchergebnisse auf dem lokalen Computer durch. Legen Sie die CacheResults-Eigenschaft auf true fest, um Verzeichnisinformationen auf dem lokalen Computer zu speichern. Aktualisierungen werden in diesem lokalen Cache durchgeführt und nur in Active Directory übernommen, wenn die DirectoryEntry.CommitChanges-Methode aufgerufen wird.

• Geben Sie mithilfe der ServerTimeLimit-Eigenschaft an, wie lange gesucht werden soll.

• Rufen Sie nur Attributnamen ab. Legen Sie die PropertyNamesOnly-Eigenschaft auf true fest, um nur die Namen der Attribute mit zugewiesenen Werten abzurufen.

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

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

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

.NET Framework-Sicherheit

• DirectoryServicesPermission  LinkDemand

Vererbungshierarchie

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
      System.DirectoryServices.DirectorySearcher

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

DirectorySearcher-Member
System.DirectoryServices-Namespace
DirectoryEntries-Klasse
DirectoryEntry-Klasse
DirectorySearcher
DirectorySearcher-Klasse
DirectorySearcher-Klasse
PropertyCollection
PropertyValueCollection
ReferralChasingOption
SearchResultCollection
SearchResult
ResultPropertyValueCollection
ResultPropertyValueCollection
SearchScope
SortDirection
SortOption
System.DirectoryServices