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 。有关详细信息，请参阅按示例查询概述主题。