PrincipalSearcher.FindOne Metoda

Definice

Obor názvů:

System.DirectoryServices.AccountManagement

Sestavení:

System.DirectoryServices.AccountManagement.dll

Balíček:

System.DirectoryServices.AccountManagement v9.0.0-preview.6.24327.7

Zdroj:

PrincipalSearcher.cs

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 ();

member this.FindOne : unit -> System.DirectoryServices.AccountManagement.Principal

Public Function FindOne () As Principal

Návraty

Principal

Objekt Principal , který obsahuje objekt zabezpečení, který odpovídá filtru dotazu, nebo null pokud nejsou nalezeny žádné výsledky.

Výjimky

InvalidOperationException

Obsahuje QueryFilter referenční vlastnosti. Další informace najdete v tématu Přehled dotazu podle příkladu .

Objekt QueryFilter je trvalý objekt zabezpečení.

ArgumentException

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 .

Viz také

• Dotaz podle příkladu