Поделиться через

Фильтрация элементов

  • Статья

В этой статье описываются общие правила для указания свойств в фильтрах, которые поддерживаются различными объектами в Outlook. Дополнительные сведения об указании условий по свойствам для выполнения фильтрации см. в статьях раздела Синтаксис фильтра.

Фильтр — это условие или набор условий, которые можно применить к набору элементов для получения подмножества элементов, отвечающих указанным условиям. Outlook поддерживает использование фильтров с помощью синтаксиса языка запросов Microsoft Jet или синтаксиса DASL. Обратите внимание, что синтаксис языка запросов Jet совпадает с синтаксисом, поддерживаемым службой Microsoft Jet Expression Service. Отсюда и название языка запросов Jet.

Например, можно отфильтровать элементы контактов в папке "Контакты" для получения списка контактов, проживающих в Канаде. В этом случае выполняется фильтрация по свойству HomeAddressCountry . Фильтр, представленный в виде фильтра Jet, будет выглядеть так: "[HomeAddressCountry] = 'Canada'".

Outlook обеспечивает фильтрацию через указанные ниже точки входа:

Точка входа Поддержка фильтра Jet Поддержка фильтра DASL
Application.AdvancedSearch Нет Да
Folder.GetTable Да Да
Items.Find Да Да. Обратите внимание, что если вы используете ключевые слова запроса ci_phrasematch или ci_startswith в фильтре, вы получите сообщение об ошибке.
Items.Restrict Да Да
Search.GetTable Нет Да
Table.FindRow Да Да. Обратите внимание, что если вы используете ключевые слова запроса ci_phrasematch или ci_startswith в фильтре, вы получите сообщение об ошибке.
Table.Restrict Да Да
View.Filter Нет Да

Примечание.

Фильтр должен содержать запрос в синтаксисе Jet или DASL, но не сочетание обоих вариантов.

Указатели свойств

При указании свойств в фильтре Jet или DASL с помощью любой точки входа, указанной выше, следуйте приведенным ниже инструкциям.

Фильтр Jet Фильтр DASL
Применимые свойства Большинство явных встроенных и настраиваемых свойств на уровне элементов; см. статью о соответствующем методе для неподдерживаемых свойств. Большинство встроенных и настраиваемых свойств на уровне элементов с явными строковыми именами или без них; см. статью о соответствующем методе для неподдерживаемых свойств.
Ссылка на свойства

  • По явным строковым именам.

  • Ссылаться на явные встроенные свойства можно только по их именам на английском языке без использования любых других языков локализации.

  • На пользовательские свойства можно ссылаться по их именам на английском или локализованном языке.

 По пространству имен.
Формат ссылки

  • Явные строковые имена нужно заключать в квадратные скобки ('['']').

  • В именах свойств не учитывается регистр.

  • В явных встроенных свойствах нельзя применять пробелы.

  • В настраиваемых свойствах допускаются пробелы.

  • Все запросы DASL начинаются префикса "@SQL=" с учетом регистра, кроме DASL запросов для Application.AdvancedSearch.

  • Ссылки на свойства по пространству имен необходимо заключать в двойные кавычки.

  • В ссылках на свойства по пространству имен учитывается регистр.

  • Если в имени настраиваемого свойства есть пробел, его нужно заменить на "%20". Как правило, кодировка URL-адреса применяется к символам в запросе DASL так же, как и в URL-адресе.
Условия ошибок Возвращает сообщение об ошибке, если настраиваемое свойство в фильтре не определено либо фильтр не заполнен, содержит недопустимый аргумент или его нельзя обработать. Возвращает сообщение об ошибке, если настраиваемое свойство в фильтре не определено либо фильтр не заполнен, содержит недопустимый аргумент или его нельзя обработать.

Синтаксис фильтров

Синтаксис фильтра зависит от типа свойства, по которому выполняется фильтрация. В указанных ниже статьях представлены дополнительные сведения о создании фильтра с учетом конкретного типа свойства:

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.