Condividi tramite


DirectorySearcher Classe

Definizione

Esegue query in Servizi di dominio Active Directory.

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
Ereditarietà
DirectorySearcher
Attributi

Commenti

Usare un DirectorySearcher oggetto per eseguire ricerche ed eseguire query su una gerarchia di Servizi di dominio Active Directory usando Ldap (Lightweight Directory Access Protocol). LDAP è l'unico provider active Directory Service Interfaces (ADSI) fornito dal sistema che supporta la ricerca di directory. Un amministratore può apportare, modificare ed eliminare oggetti trovati nella gerarchia. Per altre informazioni, vedere Uso di System.DirectoryServices.

Quando si crea un'istanza di DirectorySearcher, si specifica la radice da recuperare e un elenco facoltativo di proprietà da recuperare. La SearchRoot proprietà consente di impostare proprietà aggiuntive per eseguire le attività seguenti:

  • Memorizzare nella cache i risultati della ricerca nel computer locale. Impostare la proprietà su per true archiviare le CacheResults informazioni sulla directory nel computer locale. Gli aggiornamenti vengono eseguiti in questa cache locale e vengono sottoposti a commit in Servizi di dominio Active Directory solo quando viene chiamato il DirectoryEntry.CommitChanges metodo.

  • Specificare il tempo di ricerca, usando la ServerTimeLimit proprietà .

  • Recuperare solo i nomi degli attributi. Impostare la PropertyNamesOnly proprietà su true per recuperare solo i nomi degli attributi a cui sono stati assegnati i valori.

  • Eseguire una ricerca in pagina. Impostare la PageSize proprietà per specificare il numero massimo di oggetti restituiti in una ricerca in pagina. Se non si vuole eseguire una ricerca in pagina, impostare la PageSize proprietà sul valore predefinito di zero.

  • Specificare il numero massimo di voci da restituire usando la SizeLimit proprietà . Se si imposta la SizeLimit proprietà sul valore predefinito di zero, il valore predefinito determinato dal server è 1000 voci.

Nota

Se il numero massimo di voci restituite e limiti di tempo superano le limitazioni impostate nel server, le impostazioni del server eseguono l'override delle impostazioni del componente.

Per un elenco dei valori iniziali delle proprietà di un'istanza della classe DirectorySearcher, vedere il costruttore DirectorySearcher().

Nota

Si presuppone che sia disponibile una conoscenza generale dei servizi di dominio Active Directory prima di usare questa classe. Per altre informazioni, vedere la System.DirectoryServices panoramica.

Costruttori

DirectorySearcher()

Inizializza una nuova istanza della classe DirectorySearcher con i valori predefiniti.

DirectorySearcher(DirectoryEntry)

Inizializza una nuova istanza della classe DirectorySearcher utilizzando il percorso di ricerca specificato.

DirectorySearcher(DirectoryEntry, String)

Inizializza una nuova istanza della classe DirectorySearcher con il percorso di ricerca e il filtro di ricerca specificati.

DirectorySearcher(DirectoryEntry, String, String[])

Inizializza una nuova istanza della classe DirectorySearcher con il percorso di ricerca, il filtro di ricerca e le proprietà da recuperare specificati.

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

Inizializza una nuova istanza della classe DirectorySearcher con il percorso di ricerca, il filtro di ricerca, le proprietà da recuperare e l'ambito di ricerca specificati.

DirectorySearcher(String)

Inizializza una nuova istanza della classe DirectorySearcher con il filtro di ricerca specificato.

DirectorySearcher(String, String[])

Inizializza una nuova istanza della classe DirectorySearcher con il filtro di ricerca e le proprietà da recuperare specificati.

DirectorySearcher(String, String[], SearchScope)

Inizializza una nuova istanza della classe DirectorySearcher con il filtro di ricerca, le proprietà da recuperare e l'ambito di ricerca specificati.

Proprietà

Asynchronous

Ottiene o imposta un valore che indica se la ricerca viene eseguita in modo asincrono.

AttributeScopeQuery

Ottiene o imposta il nome visualizzato LDAP dell'attributo con nome distinto in cui effettuare la ricerca. Per questo tipo di ricerca può essere utilizzato un solo attributo.

CacheResults

Recupera o imposta un valore che indica se il risultato è memorizzato nella cache del computer client.

CanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.

(Ereditato da Component)
ClientTimeout

Recupera o imposta il tempo massimo di attesa del client per la restituzione dei risultati da parte del server. Se il server non risponde nell'intervallo di tempo specificato, la ricerca verrà interrotta e non verrà restituito alcun risultato.

Container

Ottiene l'oggetto IContainer che contiene Component.

(Ereditato da Component)
DerefAlias

Ottiene o imposta un valore che indica come vengono risolti gli alias degli oggetti trovati nel corso di una ricerca.

DesignMode

Ottiene un valore che indica se il Component si trova in modalità progettazione.

(Ereditato da Component)
DirectorySynchronization

Ottiene o imposta un oggetto che rappresenta il controllo di sincronizzazione directory da utilizzare con la ricerca.

Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.

(Ereditato da Component)
ExtendedDN

Ottiene o imposta un valore che indica il formato dei nomi distinti.

Filter

Ottiene o imposta un valore che indica la stringa di filtro in formato LDAP (Lightweight Directory Access Protocol).

PageSize

Ottiene o imposta un valore che indica la dimensione della pagina in una ricerca per pagina.

PropertiesToLoad

Ottiene un valore che indica l'elenco delle proprietà da recuperare durante la ricerca.

PropertyNamesOnly

Recupera o imposta un valore che indica se la ricerca viene effettuata soltanto sui nomi di attributi a cui sono stati assegnati valori.

ReferralChasing

Ottiene o imposta un valore che indica la modalità di ricerca dei riferimenti.

SearchRoot

Ottiene o imposta un valore che indica il nodo della gerarchia dei Servizi di dominio Active Directory in cui viene avviata la ricerca.

SearchScope

Ottiene o imposta un valore che indica l'ambito della ricerca visualizzato dal server.

SecurityMasks

Ottiene o imposta un valore che indica quali informazioni sull'accesso di sicurezza per gli attributi specificati devono essere restituite dalla ricerca.

ServerPageTimeLimit

Ottiene o imposta un valore che indica la durata massima della ricerca di una singola pagina di risultati da parte del server. Questo valore è diverso dal limite di tempo definito per l'intera ricerca.

ServerTimeLimit

La proprietà ServerTimeLimit ottiene o imposta un valore che indica il tempo massimo consentito al server per la ricerca. Se viene raggiunto il limite di tempo, verranno restituite soltanto le voci trovate fino a quel momento.

Site

Ottiene o imposta l'oggetto ISite di Component.

(Ereditato da Component)
SizeLimit

Ottiene o imposta un valore che indica il numero massimo di oggetti che il server restituisce in una ricerca.

Sort

Ottiene o imposta un valore che indica la proprietà in base alla quale vengono ordinati i risultati.

Tombstone

Ottiene o imposta un valore che indica se la ricerca deve restituire anche gli oggetti eliminati che corrispondono al filtro di ricerca.

VirtualListView

Ottiene o imposta un valore che indica le opzioni di visualizzazione elenco virtuale per la ricerca.

Metodi

CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.

(Ereditato da MarshalByRefObject)
Dispose()

Rilascia tutte le risorse usate da Component.

(Ereditato da Component)
Dispose(Boolean)

Rilascia le risorse gestite utilizzate dall'oggetto DirectorySearcher ed eventualmente le risorse non gestite.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
FindAll()

Esegue la ricerca e restituisce l'insieme delle voci trovate.

FindOne()

Esegue la ricerca restituendo solo la prima voce trovata.

GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetLifetimeService()
Obsoleti.

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.

(Ereditato da MarshalByRefObject)
GetService(Type)

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.

(Ereditato da Component)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
InitializeLifetimeService()
Obsoleti.

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.

(Ereditato da MarshalByRefObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.

(Ereditato da MarshalByRefObject)
ToString()

Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component. Questo metodo non deve essere sottoposto a override.

(Ereditato da Component)

Eventi

Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().

(Ereditato da Component)

Si applica a

Vedi anche