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.PrincipalPublic Function FindOne () As PrincipalВозвращаемое значение
Объект Principal , содержащий основной объект, соответствующий фильтру запроса, или null значение , если результаты не найдены.
- Атрибуты
Исключения
Коллекция QueryFilter содержит ссылочные свойства. Дополнительные сведения см. в разделе общих сведений о Query by Example.
Объект QueryFilter является постоянным участником.
Прежде чем будет выполнен запрос, объект QueryFilter сначала должен быть назначен объекту для поиска участников.
Комментарии
Если имеется ровно одно совпадение объекта, указанного в QueryFilter, этот метод возвращает этот объект. При наличии нескольких совпадений QueryFilter объекта этот метод произвольно возвращает один из соответствующих субъектов.
Объект, Principal возвращаемый этим методом, соответствует типу объекта, содержащегося в свойстве QueryFilter . Поиск выполняется в контексте, указанном в свойстве Context . Дополнительные сведения см. в разделе общих сведений о Query by Example.
