PrincipalSearcher.FindOne Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Retourneert een principal-zoekresultaat dat het eerste principal-object bevat dat overeenkomt met de principal die is opgegeven in de QueryFilter eigenschap.
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 PrincipalRetouren
Een Principal object dat het principal-object bevat dat overeenkomt met het queryfilter of null als er geen resultaten worden gevonden.
- Kenmerken
Uitzonderingen
De QueryFilter bevat referentiële eigenschappen. Zie het overzichtsonderwerp Query by Example voor meer informatie.
Dit QueryFilter is een persistente principal.
Een QueryFilter moet eerst worden toegewezen aan de principalzoeker voordat de query kan worden uitgevoerd.
Opmerkingen
Als er precies één overeenkomst is met het object dat is opgegeven in de QueryFilter, retourneert deze methode dat object. Als er meerdere overeenkomsten van het QueryFilter object zijn, retourneert deze methode willekeurig een van de overeenkomende principals.
Het Principal object dat door deze methode wordt geretourneerd, komt overeen met het type object dat in de QueryFilter eigenschap is opgenomen. De zoekopdracht wordt uitgevoerd in de context die is opgegeven in de Context eigenschap. Zie het overzichtsonderwerp Query by Example voor meer informatie.
