PrincipalSearcher.FindOne Metoda

Definice

Obor názvů:

System.DirectoryServices.AccountManagement

Sestavení:

System.DirectoryServices.AccountManagement.dll

Balíček:

System.DirectoryServices.AccountManagement v8.0.0

Zdroj:

PrincipalSearcher.cs

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

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

Public Function FindOne () As Principal

Návraty

Principal

Objekt Principal obsahující objekt instanční objekt, který odpovídá filtru dotazu, nebo null pokud nebyly nalezeny žádné výsledky.

Výjimky

InvalidOperationException

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í.

ArgumentException

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 .

Viz také

• Dotazování podle příkladu