Propriedade Form.ServerFilter (Access)

Utilize a propriedade ServerFilter para especificar um subconjunto de registos a apresentar quando um filtro de servidor é aplicado a um formulário dentro de um projeto do Microsoft Access (.adp) ou base 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 seguinte código do Visual Basic 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 ao escrever o seguinte código:

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

Utilize a propriedade ServerFilter para guardar um filtro e aplicá-lo mais tarde. 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 guardado a um formulário, pode escolher Aplicar Filtro de Servidor na barra de ferramentas, selecionar Aplicar Filtro/Ordenar no menu Registos ou utilizar uma macro ou Visual Basic para definir a propriedade ServerFilterByForm como Verdadeiro.

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.

Só pode remover um filtro de servidor utilizando o Visual Basic para definir a propriedade ServerFilterByForm como Falso ou limpar todos os critérios de filtro na janela Filtrar Por Formulário do Servidor e, em seguida, selecione 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.