PrincipalSearcher.FindOne 方法

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

傳回主體搜尋結果，其中包含第一個找到符合 QueryFilter 屬性中指定之主體的主體物件。

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

Principal物件，包含符合查詢篩選準則的主體物件，如果 null 找不到任何結果，則為。

QueryFilter 內含參考屬性。如需詳細資訊，請參閱依範例查詢的概觀主題。

QueryFilter 是永續性的主體。

QueryFilter 必須先指派給主體搜尋器，才能執行查詢。

如果中 QueryFilter 指定的物件完全相符，這個方法會傳回該物件。如果物件有多個相符 QueryFilter 專案，這個方法會任意傳回其中一個相符的主體。

Principal從這個方法傳回的物件符合屬性中包含的 QueryFilter 物件類型。搜尋是在屬性中指定的內容中 Context 執行。如需詳細資訊，請參閱依範例查詢的概觀主題。