PrincipalSearcher.FindOne Metodo

Definizione

Spazio dei nomi:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Pacchetto:

System.DirectoryServices.AccountManagement v8.0.0

Source:

PrincipalSearcher.cs

Restituisce un risultato della ricerca Principal che contiene il primo oggetto Principal che corrisponde all'oggetto Principal specificato nella proprietà QueryFilter.

public:
 System::DirectoryServices::AccountManagement::Principal ^ FindOne();

public System.DirectoryServices.AccountManagement.Principal FindOne ();

member this.FindOne : unit -> System.DirectoryServices.AccountManagement.Principal

Public Function FindOne () As Principal

Restituisce

Principal

Oggetto Principal contenente l'oggetto principale che corrisponde al filtro di query o null se non vengono trovati risultati.

Eccezioni

InvalidOperationException

L'oggetto QueryFilter contiene proprietà referenziali. Per altre informazioni, vedere l'argomento introduttivo su Query by Example.

QueryFilter è un oggetto Principal persistente.

ArgumentException

Un oggetto QueryFilter deve essere assegnato al ricercatore Principal prima che la query possa essere eseguita.

Commenti

Se è presente esattamente una corrispondenza dell'oggetto QueryFilterspecificato in , questo metodo restituisce tale oggetto. Se sono presenti più corrispondenze dell'oggetto QueryFilter , questo metodo restituisce arbitrariamente una delle entità corrispondenti.

L'oggetto Principal restituito da questo metodo corrisponde al tipo di oggetto contenuto nella QueryFilter proprietà. La ricerca viene eseguita nel contesto specificato nella Context proprietà. Per altre informazioni, vedere l'argomento introduttivo su Query by Example.

Vedi anche

• Query by Example