Propriété Form.Filter (Access)

Utilisez la propriété Filter pour spécifier un sous-ensemble d’enregistrements à afficher lorsqu’un filtre est appliqué à un formulaire, un état, une requête ou une table. String en lecture/écriture.

Syntaxe

expression.Filtre

expressionVariable qui représente un objetForm.

Remarques

Si vous souhaitez spécifier un filtre serveur dans un projet Microsoft Access (.adp) pour les données situées sur un serveur, utilisez la propriété ServerFilter (FiltreServeur).

La propriété Filter est une expression de chaîne qui comprend une clause WHERE sans le mot clé WHERE. Par exemple, le code Visual Basic suivant définit et applique un filtre pour afficher uniquement les clients des États-Unis.

Me.Filter = "Country = 'USA'" 
Me.FilterOn = True

Remarque

La définition de la propriété Filter n’a aucun effet sur la propriété Filtre ADO.

Utilisez la propriété Filter pour enregistrer un filtre et l’appliquer ultérieurement. Les filtres sont enregistrés avec les objets dans lesquels ils sont créés. Ils sont automatiquement chargés à l'ouverture de l'objet, mais ils ne sont pas automatiquement appliqués.

Lorsqu’un objet est créé, il hérite des propriétés RecordSource, Filter, OrderBy et OrderByOn de la table ou de la requête à partir de laquelle il a été créé.

Pour appliquer un filtre enregistré à un formulaire, une requête ou une table, vous pouvez choisir Appliquer un filtre dans la barre d’outils, choisir Appliquer le filtre/trier dans le menu Enregistrements ou utiliser une macro ou Visual Basic pour définir la propriété FilterOn sur True. Pour les états, vous pouvez appliquer un filtre en attribuant Oui à la propriété FilterOn dans la feuille des propriétés de l'état.

Le bouton Appliquer le filtre indique l'état des propriétés Filter et FilterOn (FiltreActif). Ce bouton n'est activé que si un filtre doit être appliqué. Si un filtre existant est déjà appliqué, le bouton Appliquer le filtre apparaît enfoncé.

Pour appliquer automatiquement un filtre lors de l'ouverture d'un formulaire, spécifiez dans le paramètre de propriété d'événement OnOpen du formulaire une macro qui utilise l'action AppliquerFiltre ou une procédure événementielle qui utilise la méthode ApplyFilter de l'objet DoCmd.

Vous pouvez supprimer un filtre en choisissant le bouton Appliquer le filtre enfoncé, en choisissant Supprimer le filtre/trier dans le menu Enregistrements ou en utilisant Visual Basic pour définir la propriété FilterOn sur False.

Lorsque la propriété Filter est définie en mode Création de formulaire, Microsoft Access ne tente pas de valider l’expression SQL. Si cette expression n’est pas valide, une erreur se produit lors de l’application du filtre.

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.