Симон Робинсон - C# для профессионалов. Том II

Большую часть времени активный каталог будет использоваться для поиска некоторых значений. Это хранилище данных, которое оптимизировано в основном для чтения, поэтому данные будут в основном считываться.

Для поиска в активном каталоге платформа .NET имеет класс DirectorySearcher.

Мы можем использовать поиск только с провайдером LDAP. DirectorySearcherне работает с провайдерами NDS или IIS.

В конструкторе класса DirectorySearcherсуществуют четыре важные части поиска. Можно также использовать конструктор по умолчанию и определять параметры поиска с помощью свойств.

Корень поиска ( SearchRoot) определяет, где должен начаться поиск. По умолчанию SearchRootявляется корнем домена, который используется в данный момент. SearchRootопределен с помощью свойства Pathобъекта DirectoryEntry.

Фильтр (Filter) определяет значения, которые мы хотим найти. Фильтр является строкой, которая должна быть заключена в круглые скобки.

Операторы отношений, такие как <=, =, >=, в выражениях допускаются. ( objectClass = contact) будет искать все объекты типа contact; ( lastName>=Nagel) ищет все объекты, где свойство lastNameравно или больше Nagel, что означает, что оно следует за ним в алфавитном порядке.

Выражения могут комбинироваться с префиксными операциями &и |. ( &(objectClass=user)(description=Auth*)) ищет все объекты типа user, где свойство descriptionначинается со строки Auth. Так как операторы &и |находятся в начале выражения, то с помощью одного префиксного оператора можно комбинировать более двух выражений.

По умолчанию используется фильтр ( objectClass=*), поэтому все объекты допустимы. Синтаксис фильтра определен в RFC 2254, "Строковое представление фильтров поиска LDAP". Этот RFC можно найти по адресу www.ietf.org/rfc/rfc2254.txt.

С помощью PropertiesToLoadмы определяем коллекцию StringCollectionвсех интересующих нас свойств. Как вы уже видели, объекты могут иметь множество свойств. Большинство из них будут не важны для нашего запроса поиска. Мы определяем свойства, загружаемые в кэш. Свойствами по умолчанию, которые мы получаем, если ничего не определено, являются Pathи Nameдля объекта.

SearchScopeявляется перечислением, которое определяет, как глубоко должен распространяться поиск:

□ SearchScope.Baseищет атрибуты только в том объекте, где начинается поиск, поэтому мы получаем максимум один объект.

□ Для SearchScope.OneLevelпоиск продолжается в коллекции-потомке базового объекта. Сам базовый объект для поиска не используется.

□ SearchScope.Subtreeопределяет, что поиск должен спускаться вниз по всему дереву.

По умолчанию для SearchScopeиспользуется Subtree.

Такой поиск может охватывать несколько доменов. Чтобы ограничить поиск некоторым числом объектов или требуемым временем, необходимо определить несколько дополнительных свойств.

В рассматриваемом примере поиска мы хотим найти все объекты пользователей в организационной единице Wrox Press, где свойство descriptionсодержит значение Author.