DirectorySearcher Classe

Riferimento

Definizione

Spazio dei nomi:: System.DirectoryServices

Assembly:: System.DirectoryServices.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

MarshalByRefObject

Component
DirectorySearcher

Attributi: DSDescriptionAttribute

Commenti

Usare un DirectorySearcher oggetto per cercare ed eseguire query su una gerarchia di Active Directory Domain Services usando LDAP (Lightweight Directory Access Protocol). LDAP è l'unico provider ACTIVE Directory Service Interfaces (ADSI) fornito dal sistema che supporta la ricerca nella directory. Un amministratore può creare, modificare ed eliminare oggetti presenti 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 CacheResults proprietà su true per archiviare le informazioni sulla directory nel computer locale. Aggiornamenti vengono eseguite in questa cache locale ed è stato eseguito il commit in Active Directory Domain Services solo quando viene chiamato il DirectoryEntry.CommitChanges metodo .
Specificare il periodo di tempo per la ricerca, utilizzando 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 con paging. Impostare la PageSize proprietà per specificare il numero massimo di oggetti restituiti in una ricerca con paging. Se non si vuole eseguire una ricerca con paging, impostare la PageSize proprietà sul valore predefinito zero.
Specificare il numero massimo di voci da restituire usando la SizeLimit proprietà . Se si imposta la SizeLimit proprietà sul valore predefinito 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 sostituiscono le 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 si abbia una conoscenza generale di Active Directory Domain Services 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()	Obsoleta. 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()	Obsoleta. 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