PrincipalSearcher.FindOne Метод

Определение

Пространство имен:

System.DirectoryServices.AccountManagement

Сборка:

System.DirectoryServices.AccountManagement.dll

Пакет:

System.DirectoryServices.AccountManagement v8.0.0

Исходный код:

PrincipalSearcher.cs

Возвращает результат поиска участника, который содержит первый найденный объект-участник, соответствующий участнику, указанному в свойстве QueryFilter.

public:
 System::DirectoryServices::AccountManagement::Principal ^ FindOne();

public System.DirectoryServices.AccountManagement.Principal FindOne ();

member this.FindOne : unit -> System.DirectoryServices.AccountManagement.Principal

Public Function FindOne () As Principal

Возвращаемое значение

Principal

Объект Principal , содержащий основной объект, соответствующий фильтру запроса, или null значение , если результаты не найдены.

Исключения

InvalidOperationException

Коллекция QueryFilter содержит ссылочные свойства. Дополнительные сведения см. в разделе общих сведений о Query by Example.

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

ArgumentException

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

Комментарии

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

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

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

• Query By Example