PrincipalSearcher.FindOne Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 ();[System.Security.SecurityCritical]
public System.DirectoryServices.AccountManagement.Principal FindOne ();member this.FindOne : unit -> System.DirectoryServices.AccountManagement.Principal[<System.Security.SecurityCritical>]
member this.FindOne : unit -> System.DirectoryServices.AccountManagement.PrincipalPublic Function FindOne () As PrincipalRetours
Objet Principal qui contient l’objet principal qui correspond au filtre de requête ou null si aucun résultat n’est trouvé.
- Attributs
Exceptions
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.
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).
