PrincipalSearcher.FindOne Metodo

Definizione

Spazio dei nomi:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Pacchetto:

System.DirectoryServices.AccountManagement v9.0.0-preview.6.24327.7

Origine:

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 principal 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 specificato in QueryFilter, 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