DirectorySearcher Klasse
Definition
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::Componentpublic class DirectorySearcher : System.ComponentModel.Component[System.DirectoryServices.DSDescription("DirectorySearcherDesc")]
public class DirectorySearcher : System.ComponentModel.Componenttype DirectorySearcher = class
inherit Component[<System.DirectoryServices.DSDescription("DirectorySearcherDesc")>]
type DirectorySearcher = class
inherit ComponentPublic Class DirectorySearcher
Inherits Component- Vererbung
- 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) |
