DirectorySearcher DirectorySearcher DirectorySearcher DirectorySearcher Class

Definizione

Esegue query in Servizi di dominio Active Directory.Performs queries against Active Directory Domain Services.

public ref class DirectorySearcher : System::ComponentModel::Component
[System.DirectoryServices.DSDescription("DirectorySearcherDesc")]
public class DirectorySearcher : System.ComponentModel.Component
type DirectorySearcher = class
    inherit Component
Public Class DirectorySearcher
Inherits Component
Ereditarietà
Attributi

Commenti

Usare un DirectorySearcher oggetto per cercare ed eseguire query su una gerarchia di Active Directory Domain Services usando Lightweight Directory Access Protocol (LDAP).Use a DirectorySearcher object to search and perform queries against an Active Directory Domain Services hierarchy using Lightweight Directory Access Protocol (LDAP). LDAP è l'unico provider ADSI (Active Directory Service Interface) fornito dal sistema che supporta la ricerca nella directory.LDAP is the only system-supplied Active Directory Service Interfaces (ADSI) provider that supports directory searching. Un amministratore può creare, modificare ed eliminare oggetti presenti nella gerarchia.An administrator can make, alter, and delete objects that are found in the hierarchy. Per ulteriori informazioni, vedere utilizzo di System. DirectoryServices.For more information, see Using System.DirectoryServices.

Quando si crea un'istanza di DirectorySearcher, è necessario specificare la radice che si desidera recuperare e un elenco facoltativo di proprietà da recuperare.When you create an instance of DirectorySearcher, you specify the root you want to retrieve, and an optional list of properties to retrieve. La SearchRoot proprietà consente di impostare proprietà aggiuntive per eseguire le attività seguenti:The SearchRoot property enables you to set additional properties to do the following tasks:

  • Memorizzare nella cache i risultati della ricerca nel computer locale.Cache the search results on the local computer. Impostare la CacheResults true proprietà su per archiviare le informazioni di directory nel computer locale.Set the CacheResults property to true to store directory information on the local computer. Gli aggiornamenti vengono eseguiti in questa cache locale ed è stato eseguito il commit DirectoryEntry.CommitChanges in Active Directory Domain Services solo quando viene chiamato il metodo.Updates are made to this local cache and committed to Active Directory Domain Services only when the DirectoryEntry.CommitChanges method is called.

  • Consente di specificare l'intervallo di tempo di ricerca, ServerTimeLimit utilizzando la proprietà.Specify the length of time to search, using the ServerTimeLimit property.

  • Recuperare solo i nomi di attributo.Retrieve attribute names only. Impostare la PropertyNamesOnly proprietà su true per recuperare solo i nomi degli attributi a cui sono stati assegnati i valori.Set the PropertyNamesOnly property to true to retrieve only the names of attributes to which values have been assigned.

  • Eseguire una ricerca di paging.Perform a paged search. Impostare la PageSize proprietà per specificare il numero massimo di oggetti restituiti in una ricerca di paging.Set the PageSize property to specify the maximum number of objects that are returned in a paged search. Se non si desidera eseguire una ricerca di paging, impostare la PageSize proprietà sul valore predefinito pari a zero.If you do not want to perform a paged search, set the PageSize property to its default of zero.

  • Consente di specificare il numero massimo di voci da restituire utilizzando SizeLimit la proprietà.Specify the maximum number of entries to return, using the SizeLimit property. Se si imposta la SizeLimit proprietà sul valore predefinito pari a zero, il valore predefinito determinato dal server è 1000 voci.If you set the SizeLimit property to its default of zero, the server-determined default is 1000 entries.

Nota

Se il numero massimo di voci e limiti di tempo restituiti supera le limitazioni impostate nel server, le impostazioni del server sostituiscono le impostazioni del componente.If the maximum number of returned entries and time limits exceed the limitations that are set on the server, the server settings override the component settings.

Per un elenco dei valori iniziali delle proprietà di un'istanza della classe DirectorySearcher, vedere il costruttore DirectorySearcher().For a list of initial property values for an instance of the DirectorySearcher class, see the DirectorySearcher() constructor.

Nota

Si presuppone che l'utente abbia una conoscenza generale di Active Directory Domain Services prima di utilizzare questa classe.It is assumed that you have a general understanding of Active Directory Domain Services before using this class. Per ulteriori informazioni, vedere la System.DirectoryServices panoramica.For more information, see the System.DirectoryServices overview.

Costruttori

DirectorySearcher() DirectorySearcher() DirectorySearcher() DirectorySearcher()

Inizializza una nuova istanza della classe DirectorySearcher con i valori predefiniti.Initializes a new instance of the DirectorySearcher class with default values.

DirectorySearcher(DirectoryEntry) DirectorySearcher(DirectoryEntry) DirectorySearcher(DirectoryEntry) DirectorySearcher(DirectoryEntry)

Inizializza una nuova istanza della classe DirectorySearcher utilizzando il percorso di ricerca specificato.Initializes a new instance of the DirectorySearcher class using the specified search root.

DirectorySearcher(DirectoryEntry, String) DirectorySearcher(DirectoryEntry, String) DirectorySearcher(DirectoryEntry, String) DirectorySearcher(DirectoryEntry, String)

Inizializza una nuova istanza della classe DirectorySearcher con il percorso di ricerca e il filtro di ricerca specificati.Initializes a new instance of the DirectorySearcher class with the specified search root and search filter.

DirectorySearcher(DirectoryEntry, String, String[]) DirectorySearcher(DirectoryEntry, String, String[]) DirectorySearcher(DirectoryEntry, String, String[]) 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.Initializes a new instance of the DirectorySearcher class with the specified search root, search filter, and properties to retrieve.

DirectorySearcher(DirectoryEntry, String, String[], SearchScope) DirectorySearcher(DirectoryEntry, String, String[], SearchScope) DirectorySearcher(DirectoryEntry, String, String[], SearchScope) 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.Initializes a new instance of the DirectorySearcher class with the specified search root, search filter, properties to retrieve, and search scope.

DirectorySearcher(String) DirectorySearcher(String) DirectorySearcher(String) DirectorySearcher(String)

Inizializza una nuova istanza della classe DirectorySearcher con il filtro di ricerca specificato.Initializes a new instance of the DirectorySearcher class with the specified search filter.

DirectorySearcher(String, String[]) DirectorySearcher(String, String[]) DirectorySearcher(String, String[]) DirectorySearcher(String, String[])

Inizializza una nuova istanza della classe DirectorySearcher con il filtro di ricerca e le proprietà da recuperare specificati.Initializes a new instance of the DirectorySearcher class with the specified search filter and properties to retrieve.

DirectorySearcher(String, String[], SearchScope) DirectorySearcher(String, String[], SearchScope) DirectorySearcher(String, String[], SearchScope) 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.Initializes a new instance of the DirectorySearcher class with the specified search filter, properties to retrieve, and search scope.

Proprietà

Asynchronous Asynchronous Asynchronous Asynchronous

Ottiene o imposta un valore che indica se la ricerca viene eseguita in modo asincrono.Gets or sets a value that indicates if the search is performed asynchronously.

AttributeScopeQuery AttributeScopeQuery AttributeScopeQuery AttributeScopeQuery

Ottiene o imposta il nome visualizzato LDAP dell'attributo con nome distinto in cui effettuare la ricerca.Gets or sets the LDAP display name of the distinguished name attribute to search in. Per questo tipo di ricerca può essere utilizzato un solo attributo.Only one attribute can be used for this type of search.

CacheResults CacheResults CacheResults CacheResults

Recupera o imposta un valore che indica se il risultato è memorizzato nella cache del computer client.Gets or sets a value indicating whether the result is cached on the client computer.

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
ClientTimeout ClientTimeout ClientTimeout ClientTimeout

Recupera o imposta il tempo massimo di attesa del client per la restituzione dei risultati da parte del server.Gets or sets the maximum amount of time that the client waits for the server to return results. Se il server non risponde nell'intervallo di tempo specificato, la ricerca verrà interrotta e non verrà restituito alcun risultato.If the server does not respond within this time, the search is aborted and no results are returned.

Container Container Container Container

Ottiene il IContainer che contiene il Component.Gets the IContainer that contains the Component.

(Inherited from Component)
DerefAlias DerefAlias DerefAlias DerefAlias

Ottiene o imposta un valore che indica come vengono risolti gli alias degli oggetti trovati nel corso di una ricerca.Gets or sets a value indicating how the aliases of objects that are found during a search should be resolved.

DesignMode DesignMode DesignMode DesignMode

Ottiene un valore che indica se il Component si trova in modalità progettazione.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
DirectorySynchronization DirectorySynchronization DirectorySynchronization DirectorySynchronization

Ottiene o imposta un oggetto che rappresenta il controllo di sincronizzazione directory da utilizzare con la ricerca.Gets or sets an object that represents the directory synchronization control to use with the search.

Events Events Events Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
ExtendedDN ExtendedDN ExtendedDN ExtendedDN

Ottiene o imposta un valore che indica il formato dei nomi distinti.Gets or sets a value that indicates the format of the distinguished names.

Filter Filter Filter Filter

Ottiene o imposta un valore che indica la stringa di filtro in formato LDAP (Lightweight Directory Access Protocol).Gets or sets a value indicating the Lightweight Directory Access Protocol (LDAP) format filter string.

PageSize PageSize PageSize PageSize

Ottiene o imposta un valore che indica la dimensione della pagina in una ricerca per pagina.Gets or sets a value indicating the page size in a paged search.

PropertiesToLoad PropertiesToLoad PropertiesToLoad PropertiesToLoad

Ottiene un valore che indica l'elenco delle proprietà da recuperare durante la ricerca.Gets a value indicating the list of properties to retrieve during the search.

PropertyNamesOnly PropertyNamesOnly PropertyNamesOnly PropertyNamesOnly

Recupera o imposta un valore che indica se la ricerca viene effettuata soltanto sui nomi di attributi a cui sono stati assegnati valori.Gets or sets a value indicating whether the search retrieves only the names of attributes to which values have been assigned.

ReferralChasing ReferralChasing ReferralChasing ReferralChasing

Ottiene o imposta un valore che indica la modalità di ricerca dei riferimenti.Gets or sets a value indicating how referrals are chased.

SearchRoot SearchRoot SearchRoot SearchRoot

Ottiene o imposta un valore che indica il nodo della gerarchia dei Servizi di dominio Active Directory in cui viene avviata la ricerca.Gets or sets a value indicating the node in the Active Directory Domain Services hierarchy where the search starts.

SearchScope SearchScope SearchScope SearchScope

Ottiene o imposta un valore che indica l'ambito della ricerca visualizzato dal server.Gets or sets a value indicating the scope of the search that is observed by the server.

SecurityMasks SecurityMasks SecurityMasks SecurityMasks

Ottiene o imposta un valore che indica quali informazioni sull'accesso di sicurezza per gli attributi specificati devono essere restituite dalla ricerca.Gets or sets a value indicating which security access information for the specified attributes should be returned by the search.

ServerPageTimeLimit ServerPageTimeLimit ServerPageTimeLimit ServerPageTimeLimit

Ottiene o imposta un valore che indica la durata massima della ricerca di una singola pagina di risultati da parte del server.Gets or sets a value indicating the maximum amount of time the server should search for an individual page of results. Questo valore è diverso dal limite di tempo definito per l'intera ricerca.This is not the same as the time limit for the entire search.

ServerTimeLimit ServerTimeLimit ServerTimeLimit ServerTimeLimit

La proprietà ServerTimeLimit ottiene o imposta un valore che indica il tempo massimo consentito al server per la ricerca.The ServerTimeLimit property gets or sets a value indicating the maximum amount of time the server spends searching. Se viene raggiunto il limite di tempo, verranno restituite soltanto le voci trovate fino a quel momento.If the time limit is reached, only entries that are found up to that point are returned.

Site Site Site Site

Ottiene o imposta l'oggetto ISite di Component.Gets or sets the ISite of the Component.

(Inherited from Component)
SizeLimit SizeLimit SizeLimit SizeLimit

Ottiene o imposta un valore che indica il numero massimo di oggetti che il server restituisce in una ricerca.Gets or sets a value indicating the maximum number of objects that the server returns in a search.

Sort Sort Sort Sort

Ottiene o imposta un valore che indica la proprietà in base alla quale vengono ordinati i risultati.Gets or sets a value indicating the property on which the results are sorted.

Tombstone Tombstone Tombstone Tombstone

Ottiene o imposta un valore che indica se la ricerca deve restituire anche gli oggetti eliminati che corrispondono al filtro di ricerca.Gets or sets a value indicating whether the search should also return deleted objects that match the search filter.

VirtualListView VirtualListView VirtualListView VirtualListView

Ottiene o imposta un valore che indica le opzioni di visualizzazione elenco virtuale per la ricerca.Gets or sets a value indicating the virtual list view options for the search.

Metodi

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Rilascia tutte le risorse usate da Component.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Rilascia le risorse gestite utilizzate dall'oggetto DirectorySearcher ed eventualmente le risorse non gestite.Releases the managed resources that are used by the DirectorySearcher object and, optionally, releases unmanaged resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindAll() FindAll() FindAll() FindAll()

Esegue la ricerca e restituisce l'insieme delle voci trovate.Executes the search and returns a collection of the entries that are found.

FindOne() FindOne() FindOne() FindOne()

Esegue la ricerca restituendo solo la prima voce trovata.Executes the search and returns only the first entry that is found.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
ToString() ToString() ToString() ToString()

Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component.Returns a String containing the name of the Component, if any. Questo metodo non deve essere sottoposto a override.This method should not be overridden.

(Inherited from Component)

Eventi

Disposed Disposed Disposed Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

Sicurezza

DirectoryServicesPermission
LinkDemand

Si applica a

Vedi anche