PrincipalSearcher.FindOne Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vrátí výsledek hledání objektu instančního objektu, který obsahuje první nalezený objekt zabezpečení, který odpovídá objektu zabezpečení zadanému QueryFilter ve vlastnosti.
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 PrincipalNávraty
Objekt Principal , který obsahuje objekt zabezpečení, který odpovídá filtru dotazu, nebo null pokud nejsou nalezeny žádné výsledky.
- Atributy
Výjimky
Obsahuje QueryFilter referenční vlastnosti. Další informace najdete v tématu Přehled dotazu podle příkladu .
Objekt QueryFilter je trvalý objekt zabezpečení.
Před QueryFilter provedením dotazu musí být nejprve přiřazena hlavnímu vyhledávacímu objektu.
Poznámky
Pokud existuje přesně jedna shoda objektu zadaného v objektu QueryFilter, vrátí tato metoda tento objekt. Pokud existuje více shod objektu QueryFilter , tato metoda libovolně vrátí jeden z odpovídajících objektů zabezpečení.
Objekt Principal vrácený z této metody odpovídá typu objektu obsaženého QueryFilter ve vlastnosti. Hledání se provádí v kontextu zadaném Context ve vlastnosti. Další informace najdete v tématu Přehled dotazu podle příkladu .
