共用方式為


PrincipalSearcher.FindOne 方法

定義

傳回主體搜尋結果,其中包含第一個找到符合 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 執行。 如需詳細資訊,請參閱依範例查詢的概觀主題。

適用於

另請參閱