PrincipalSearcher.FindOne Méthode

Définition

Espace de noms:

System.DirectoryServices.AccountManagement

Assembly:

System.DirectoryServices.AccountManagement.dll

Paquet:

System.DirectoryServices.AccountManagement v8.0.0

Source:

PrincipalSearcher.cs

Retourne un résultat de la recherche d'entités de sécurité qui contient le premier objet Principal trouvé qui correspond à l'entité de sécurité spécifiée dans la propriété 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

Retours

Principal

Objet Principal qui contient l’objet principal qui correspond au filtre de requête ou null si aucun résultat n’est trouvé.

Exceptions

InvalidOperationException

QueryFilter contient des propriétés référentielles. Pour plus d’informations, consultez la rubrique de vue d’ensemble du langage Query by Example (requête par l’exemple).

QueryFilter est une entité de sécurité persistante.

ArgumentException

Un QueryFilter doit être préalablement assigné à l'objet de recherche d'entités de sécurité avant que la requête puisse être exécutée.

Remarques

S’il existe exactement une correspondance de l’objet spécifié dans , QueryFiltercette méthode retourne cet objet. S’il existe plusieurs correspondances de l’objet QueryFilter , cette méthode retourne arbitrairement l’un des principaux correspondants.

L’objet Principal retourné par cette méthode correspond au type d’objet contenu dans la QueryFilter propriété . La recherche est effectuée dans le contexte spécifié dans la Context propriété . Pour plus d’informations, consultez la rubrique de vue d’ensemble du langage Query by Example (requête par l’exemple).

Voir aussi

• Requête par l'exemple