DirectorySearcher Classe
Definizione
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à
- 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) |