Propriedade Form.ServerFilter (Access)

Use a propriedade ServerFilter para especificar um subconjunto de registros a serem exibidos quando um filtro de servidor é aplicado a um formulário dentro de um projeto do Microsoft Access (.adp) ou banco de dados. String de leitura/gravação.

Sintaxe

expressão. ServerFilter

expressão Uma variável que representa um objeto Form.

Comentários

A propriedade ServerFilter é uma expressão de cadeia de caracteres que consiste em uma cláusula WHERE sem a palavra-chave WHERE. Por exemplo, o código do Visual Basic a seguir define e aplica um filtro para mostrar apenas clientes dos EUA.

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

Para definir a propriedade ServerFilter, você deve primeiro:

• Defina o valor da propriedade na folha de propriedades do formulário.

• Defina a propriedade no Visual Basic digitando o seguinte código:

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

Observação

[!OBSERVAçãO] A configuração da propriedade ServerFilter não tem efeito sobre a propriedade Filter do ADO.

Use a propriedade ServerFilter para salvar um filtro e aplicá-lo posteriormente. Filtros são salvos com os objetos nos quais eles são criados. Eles são carregados automaticamente quando o objeto é aberto, mas não são automaticamente aplicados.

Para aplicar um filtro salvo a um formulário, você pode escolher Aplicar Filtro de Servidor na barra de ferramentas, escolher Aplicar Filtro/Classificar no menu Registros ou usar uma macro ou Visual Basic para definir a propriedade ServerFilterByForm como True.

O botão Aplicar filtro do servidor indica o estado das propriedades ServerFilter e ServerFilterByForm. O botão permanece desativado até que haja um filtro a ser aplicado. Se um filtro existente é aplicado no momento, o botão Aplicar filtro do servidor aparece pressionado.

Para aplicar um filtro automaticamente quando um formulário é aberto, especifique na configuração da propriedade de evento OnOpen do formulário uma macro que use a ação AplicarFiltro ou um procedimento de evento que utiliza o método ApplyFilter do objeto DoCmd. Em ambos os casos, o formulário é aberto na janela Filtro do servidor por formulário.

Você só pode remover um filtro de servidor usando o Visual Basic para definir a propriedade ServerFilterByForm como False ou limpar todos os critérios de filtro na janela Filtro de Servidor por Formulário e, em seguida, escolher Aplicar Filtro de Servidor.

Quando a propriedade ServerFilter é definida no modo de Design do formulário, o Microsoft Access não tenta validar a expressão SQL. Se a expressão SQL for inválida, ocorrerá um erro quando o filtro será aplicado.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.