DirectorySearcher.Filter Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает или задает значение, указывающее строку фильтра формата LDAP (Lightweight Directory Access Protocol).
public:
property System::String ^ Filter { System::String ^ get(); void set(System::String ^ value); };
public string Filter { get; set; }
public string? Filter { get; set; }
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.DirectoryServices.DSDescription("DSFilter")]
public string Filter { get; set; }
[System.DirectoryServices.DSDescription("DSFilter")]
[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Filter { get; set; }
[System.DirectoryServices.DSDescription("DSFilter")]
[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Filter { get; set; }
member this.Filter : string with get, set
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
[<System.DirectoryServices.DSDescription("DSFilter")>]
member this.Filter : string with get, set
[<System.DirectoryServices.DSDescription("DSFilter")>]
[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Filter : string with get, set
[<System.DirectoryServices.DSDescription("DSFilter")>]
[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.StringValueConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Filter : string with get, set
Public Property Filter As String
Значение свойства
Строка фильтра поиска в формате LDAP; например "(objectClass=user)". По умолчанию используется фильтр "(objectClass=*)", задающий извлечение всех объектов.
- Атрибуты
Комментарии
Фильтр использует следующие рекомендации:
Строка должна быть заключена в круглые скобки.
Выражения могут использовать реляционные операторы: <, <=, =, =, >=, и >. Пример: "(objectClass=user)". Другой пример — "(lastName>=Davis)".
Составные выражения формируются с помощью префиксных операторов & и |. Пример: "(&(objectClass=user)(lastName= Davis))". Другой пример: "(&(objectClass=printer)(|( building=42)(building=43)))".
Если фильтр содержит атрибут типа ADS_UTC_TIME, его значение должно иметь формат yyyymmddhhmmssZ, где y, m, d, h, m и s — это год, месяц, день, час, минута и секунда соответственно. Значение секунд (ss) является необязательным. Последняя буква Z означает отсутствие разностного времени. В этом формате "10:20:00 13 мая 1999 года" становится "19990513102000Z". Обратите внимание, что доменные службы Active Directory сохраняет дату и время как координированное универсальное время (среднее по Гринвичу). Если вы указываете время без разницы по времени, вы указываете время в GMT.
Если вы не находитесь в координированном часовом поясе, вы можете добавить разностное значение в значение координированное универсальное время (вместо указания Z), чтобы указать время в соответствии с часовой поясом. Разностное значение основано на следующем: разностный = координированное универсальное время— локальный. Чтобы указать дифференциальное значение, используйте следующий формат: yyyyymmddhhmmss[+/-]hhmm. Например, "8:52:58 вечера 23 марта 1999 года" По стандартному времени Новой Зеландии (разница составляет 12 часов) указывается как "19990323205258.0+1200".
Дополнительные сведения о формате строки поиска LDAP см. в разделе Синтаксис фильтра Поиск.
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по