DirectorySearcher.Filter Свойство

  • Ссылка

Определение

Пространство имен:
System.DirectoryServices
Сборка:
System.DirectoryServices.dll
Пакет:
System.DirectoryServices v6.0.0
Пакет:
System.DirectoryServices v7.0.0
Пакет:
System.DirectoryServices v8.0.0
Пакет:
System.DirectoryServices v9.0.0-preview.2.24128.5
Исходный код:
DirectorySearcher.cs
Исходный код:
DirectorySearcher.cs
Исходный код:
DirectorySearcher.cs

Получает или задает значение, указывающее строку фильтра формата 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

Значение свойства

String

Строка фильтра поиска в формате LDAP; например "(objectClass=user)". По умолчанию используется фильтр "(objectClass=*)", задающий извлечение всех объектов.

Атрибуты
TypeConverterAttribute DSDescriptionAttribute SettingsBindableAttribute

Комментарии

Фильтр использует следующие рекомендации:

  1. Строка должна быть заключена в круглые скобки.

  2. Выражения могут использовать реляционные операторы: <, <=, =, =, >=, и >. Пример: "(objectClass=user)". Другой пример — "(lastName>=Davis)".

  3. Составные выражения формируются с помощью префиксных операторов & и |. Пример: "(&(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 см. в разделе Синтаксис фильтра Поиск.

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