Свойство Form.ServerFilter (Access)

Используйте свойство ServerFilter , чтобы указать подмножество записей, которые будут отображаться при применении фильтра сервера к форме в проекте Microsoft Access (ADP) или базе данных. Для чтения и записи, String.

Синтаксис

expression. ServerFilter

выражение: переменная, представляющая объект Form.

Замечания

Свойство ServerFilter — это строковое выражение, состоящее из предложения WHERE без ключевого слова WHERE. Например, следующий код Visual Basic определяет и применяет фильтр для отображения только клиентов из США.

Me.ServerFilter = "Country = 'USA'" 
Me.Refresh

Чтобы задать свойство ServerFilter , сначала необходимо выполнить одно из следующих действий:

• Задайте значение свойства на странице свойств формы.

• Задайте свойство в Visual Basic, введя следующий код:

    Forms(0).ServerFilter = "fieldname = value "
  

Примечание.

Установка свойства ServerFilter не влияет на свойство фильтра ADO.

Используйте свойство ServerFilter , чтобы сохранить фильтр и применить его позже. Фильтры сохраняются вместе с объектами, в которых они создаются. Они автоматически загружаются при открытии объекта, но не применяются автоматически.

Чтобы применить сохраненный фильтр к форме, можно выбрать Применить серверный фильтр на панели инструментов, выбрать Применить фильтр или сортировку в меню Записи или использовать макрос или Visual Basic, чтобы задать для свойства ServerFilterByForm значение True.

Кнопка Применить фильтр сервера указывает состояние свойств ServerFilter и ServerFilterByForm . Кнопка остается отключенной до тех пор, пока не появится фильтр для применения. Если в настоящее время применяется существующий фильтр, появится кнопка Применить фильтр сервера .

Чтобы автоматически применить фильтр при открытии формы, укажите в параметре свойства события OnOpen формы макрос, использующий действие ApplyFilter, или процедуру события, которая использует метод ApplyFilter объекта DoCmd . В любом случае форма откроется в окне Фильтр сервера по форме.

Фильтр сервера можно удалить только с помощью Visual Basic, чтобы задать свойству ServerFilterByFormзначение False , или очистить все критерии фильтра в окне Фильтр сервера по форме, а затем выбрать Применить фильтр сервера.

Если свойство ServerFilter задано в режиме конструктора, Microsoft Access не пытается проверить выражение SQL. Если выражение SQL является недопустимым, при применении фильтра возникает ошибка.

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

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