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 zabezpečení, 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.Principal
Public Function FindOne () As Principal
Návraty
Objekt Principal obsahující objekt instanční objekt, který odpovídá filtru dotazu, nebo null
pokud nebyly nalezeny žádné výsledky.
- Atributy
Výjimky
Obsahuje QueryFilter referenční vlastnosti. Další informace najdete v tématu s přehledem dotazu podle příkladu .
Objekt QueryFilter je trvalý objekt zabezpečení.
Před QueryFilter provedením dotazu musí být nejprve přiřazena k 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 náhodně vrátí jeden z odpovídajících objektů zabezpečení.
Objekt Principal vrácený touto metodou 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 s přehledem dotazu podle příkladu .
Platí pro
Viz také
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro