DirectorySearcher Klas

Definitie

Naamruimte:
System.DirectoryServices
Assembly:
System.DirectoryServices.dll

Voert query's uit op 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
Overname
Object
MarshalByRefObject
Component
DirectorySearcher
Kenmerken
DSDescriptionAttribute

Opmerkingen

Gebruik een DirectorySearcher-object om query's te zoeken en uit te voeren op een Active Directory Domain Services-hiërarchie met behulp van LDAP (Lightweight Directory Access Protocol). LDAP is de enige door het systeem geleverde Active Directory ADSI-provider (Service Interfaces) die ondersteuning biedt voor zoeken in mappen. Een beheerder kan objecten maken, wijzigen en verwijderen die zich in de hiërarchie bevinden. Zie System.DirectoryServices gebruiken voor meer informatie.

Wanneer u een exemplaar van DirectorySearchermaakt, geeft u de hoofdmap op die u wilt ophalen en een optionele lijst met eigenschappen die u wilt ophalen. Met SearchRoot de eigenschap kunt u aanvullende eigenschappen instellen om de volgende taken uit te voeren:

  • Cache de zoekresultaten op de lokale computer. Stel de eigenschap in op true het CacheResults opslaan van mapgegevens op de lokale computer. Updates worden doorgevoerd in deze lokale cache en worden alleen doorgevoerd in Active Directory Domain Services wanneer de methode DirectoryEntry.CommitChanges wordt aangeroepen.

  • Geef de tijdsduur op waarop u wilt zoeken met behulp van de ServerTimeLimit eigenschap.

  • Alleen kenmerknamen ophalen. Stel de PropertyNamesOnly eigenschap in om true alleen de namen van kenmerken op te halen waaraan waarden zijn toegewezen.

  • Voer een paginazoekopdracht uit. Stel de PageSize eigenschap in om het maximum aantal objecten op te geven dat wordt geretourneerd in een gepaginade zoekopdracht. Als u geen gepaginade zoekopdracht wilt uitvoeren, stelt u de eigenschap in op de PageSize standaardwaarde nul.

  • Geef het maximum aantal items op dat moet worden geretourneerd met behulp van de SizeLimit eigenschap. Als u de SizeLimit eigenschap instelt op de standaardwaarde van nul, is de door de server bepaald standaard 1000 vermeldingen.

Note

Als het maximum aantal geretourneerde vermeldingen en tijdslimieten de beperkingen overschrijdt die zijn ingesteld op de server, overschrijven de serverinstellingen de onderdeelinstellingen.

Zie de DirectorySearcher() constructor voor een lijst met initiële eigenschapswaarden voor een exemplaar van de DirectorySearcher klasse.

Note

Er wordt van uitgegaan dat u een algemeen begrip hebt van Active Directory Domain Services voordat u deze klasse gebruikt. Zie het System.DirectoryServices overzicht voor meer informatie.

Constructors

Name Description
DirectorySearcher()

Initialiseert een nieuw exemplaar van de DirectorySearcher klasse met standaardwaarden.
DirectorySearcher(DirectoryEntry, String, String[], SearchScope)

Initialiseert een nieuw exemplaar van de DirectorySearcher klasse met de opgegeven zoekhoofdmap, zoekfilter, eigenschappen die moeten worden opgehaald en zoekbereik.
DirectorySearcher(DirectoryEntry, String, String[])

Initialiseert een nieuw exemplaar van de DirectorySearcher klasse met de opgegeven zoekhoofdmap, zoekfilter en eigenschappen die moeten worden opgehaald.
DirectorySearcher(DirectoryEntry, String)

Initialiseert een nieuw exemplaar van de DirectorySearcher klasse met het opgegeven zoekhoofd- en zoekfilter.
DirectorySearcher(DirectoryEntry)

Initialiseert een nieuw exemplaar van de DirectorySearcher klasse met behulp van de opgegeven zoekhoofdmap.
DirectorySearcher(String, String[], SearchScope)

Initialiseert een nieuw exemplaar van de DirectorySearcher klasse met het opgegeven zoekfilter, eigenschappen die moeten worden opgehaald en zoekbereik.
DirectorySearcher(String, String[])

Initialiseert een nieuw exemplaar van de DirectorySearcher klasse met het opgegeven zoekfilter en de eigenschappen die moeten worden opgehaald.
DirectorySearcher(String)

Initialiseert een nieuw exemplaar van de DirectorySearcher klasse met het opgegeven zoekfilter.

Eigenschappen

Name Description
Asynchronous

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de zoekopdracht asynchroon wordt uitgevoerd.
AttributeScopeQuery

Hiermee wordt de LDAP-weergavenaam van het kenmerk DN-naam opgehaald of ingesteld om in te zoeken. Er kan slechts één kenmerk worden gebruikt voor dit type zoekopdracht.
CacheResults

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het resultaat is opgeslagen in de cache op de clientcomputer.
CanRaiseEvents

Hiermee wordt een waarde opgehaald die aangeeft of het onderdeel een gebeurtenis kan genereren.

(Overgenomen van Component)
ClientTimeout

Hiermee wordt de maximale hoeveelheid tijd opgehaald of ingesteld die de client wacht totdat de server resultaten retourneert. Als de server binnen deze tijd niet reageert, wordt de zoekopdracht afgebroken en worden er geen resultaten geretourneerd.
Container

Hiermee haalt u het IContainer bestand op dat de Component.

(Overgenomen van Component)
DerefAlias

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft hoe de aliassen van objecten die tijdens een zoekopdracht worden gevonden, moeten worden omgezet.
DesignMode

Hiermee wordt een waarde opgehaald die aangeeft of de Component momenteel in de ontwerpmodus is.

(Overgenomen van Component)
DirectorySynchronization

Hiermee wordt een object opgehaald of ingesteld dat het besturingselement adreslijstsynchronisatie vertegenwoordigt voor gebruik met de zoekopdracht.
Events

Hiermee haalt u de lijst met gebeurtenis-handlers op die aan dit Componentbestand zijn gekoppeld.

(Overgenomen van Component)
ExtendedDN

Hiermee wordt een waarde opgehaald of ingesteld die de notatie van de DN-namen aangeeft.
Filter

Hiermee wordt een waarde opgehaald of ingesteld die de ldap-indelingsfiltertekenreeks (Lightweight Directory Access Protocol) aangeeft.
PageSize

Hiermee wordt een waarde opgehaald of ingesteld die het paginaformaat aangeeft in een gepaginade zoekopdracht.
PropertiesToLoad

Hiermee haalt u een waarde op die de lijst met eigenschappen aangeeft die tijdens de zoekopdracht moeten worden opgehaald.
PropertyNamesOnly

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de zoekopdracht alleen de namen van kenmerken ophaalt waaraan waarden zijn toegewezen.
ReferralChasing

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft hoe verwijzingen worden verjaagd.
SearchRoot

Hiermee wordt een waarde opgehaald of ingesteld die het knooppunt in de Active Directory Domain Services hiërarchie aangeeft waar de zoekopdracht wordt gestart.
SearchScope

Hiermee wordt een waarde opgehaald of ingesteld die het bereik aangeeft van de zoekopdracht die door de server wordt waargenomen.
SecurityMasks

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft welke beveiligingstoegangsgegevens voor de opgegeven kenmerken moeten worden geretourneerd door de zoekopdracht.
ServerPageTimeLimit

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft hoe lang de server moet zoeken naar een afzonderlijke pagina met resultaten. Dit is niet hetzelfde als de tijdslimiet voor de hele zoekopdracht.
ServerTimeLimit

Met ServerTimeLimit de eigenschap wordt een waarde opgehaald of ingesteld die aangeeft hoeveel tijd de server nodig heeft om te zoeken. Als de tijdslimiet is bereikt, worden alleen vermeldingen tot dat punt geretourneerd.
Site

Haalt of stelt de ISite van de Component.

(Overgenomen van Component)
SizeLimit

Hiermee wordt een waarde opgehaald of ingesteld die het maximum aantal objecten aangeeft dat de server retourneert in een zoekopdracht.
Sort

Hiermee wordt een waarde opgehaald of ingesteld die de eigenschap aangeeft waarop de resultaten worden gesorteerd.
Tombstone

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de zoekopdracht ook verwijderde objecten moet retourneren die overeenkomen met het zoekfilter.
VirtualListView

Hiermee wordt een waarde opgehaald of ingesteld die de weergaveopties voor de virtuele lijst voor de zoekopdracht aangeeft.

Methoden

Name Description
CreateObjRef(Type)

Hiermee maakt u een object dat alle relevante informatie bevat die nodig is om een proxy te genereren die wordt gebruikt om te communiceren met een extern object.

(Overgenomen van MarshalByRefObject)
Dispose()

Alle resources die worden gebruikt door de Component.

(Overgenomen van Component)
Dispose(Boolean)

Releases van de beheerde resources die worden gebruikt door het DirectorySearcher object en, optioneel, releases onbeheerde resources.
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
FindAll()

Voert de zoekopdracht uit en retourneert een verzameling van de gevonden items.
FindOne()

Voert de zoekopdracht uit en retourneert alleen het eerste item dat is gevonden.
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetLifetimeService()

Hiermee haalt u het huidige levensduurserviceobject op waarmee het levensduurbeleid voor dit exemplaar wordt beheerd.

(Overgenomen van MarshalByRefObject)
GetService(Type)

Hiermee wordt een object geretourneerd dat een service vertegenwoordigt die wordt geleverd door of door de Component service Container.

(Overgenomen van Component)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
InitializeLifetimeService()

Hiermee haalt u een levensduurserviceobject op om het levensduurbeleid voor dit exemplaar te beheren.

(Overgenomen van MarshalByRefObject)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
MemberwiseClone(Boolean)

Hiermee maakt u een ondiepe kopie van het huidige MarshalByRefObject object.

(Overgenomen van MarshalByRefObject)
ToString()

Retourneert een String met de naam van de Component, indien van toepassing. Deze methode mag niet worden overschreven.

(Overgenomen van Component)

gebeurtenis

Name Description
Disposed

Treedt op wanneer het onderdeel wordt verwijderd door een aanroep naar de Dispose() methode.

(Overgenomen van Component)

Van toepassing op

Zie ook