Поделиться через


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 содержит ссылочные свойства. Дополнительные сведения см. в разделе общих сведений о Query by Example.

Объект QueryFilter является постоянным участником.

Прежде чем будет выполнен запрос, объект QueryFilter сначала должен быть назначен объекту для поиска участников.

Комментарии

Если имеется ровно одно совпадение объекта, указанного в QueryFilter, этот метод возвращает этот объект. При наличии нескольких совпадений QueryFilter объекта этот метод произвольно возвращает один из соответствующих субъектов.

Объект, Principal возвращаемый этим методом, соответствует типу объекта, содержащегося в свойстве QueryFilter . Поиск выполняется в контексте, указанном в свойстве Context . Дополнительные сведения см. в разделе общих сведений о Query by Example.

Применяется к

См. также раздел