Propriété Form.ServerFilter (Access)

Utilisez la propriété ServerFilter pour spécifier un sous-ensemble d’enregistrements à afficher lorsqu’un filtre serveur est appliqué à un formulaire dans un projet Microsoft Access (.adp) ou une base de données. String en lecture/écriture.

Syntaxe

expression. ServerFilter

expressionVariable qui représente un objetForm.

Remarques

La propriété ServerFilter (FiltreServeur) est une expression de chaîne constituée d'une clause WHERE sans le mot réservé WHERE. Par exemple, le code Visual Basic suivant définit et applique un filtre pour afficher uniquement les clients des États-Unis.

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

Pour définir la propriété ServerFilter (FiltreServeur), vous devez d'abord :

• Définissez la valeur de la propriété dans la feuille de calcul du formulaire.

• Définissez la propriété dans Visual Basic en tapant le code suivant :

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

Remarque

[!REMARQUE] Définition de la propriété ServerFilter n'a aucun effet sur la propriété ADO Filter.

Utilisez la propriété ServerFilter 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.

Pour appliquer un filtre enregistré à un formulaire, vous pouvez choisir Appliquer le filtre serveur 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é ServerFilterByForm sur True.

Le bouton Appliquer un filtre serveur indique l'état des propriétés ServerFilter et ServerFilterByForm. Le bouton reste désactivé jusqu'à ce qu'il existe un filtre à appliquer. Si un filtre existant est actuellement appliqué, le bouton Appliquer un filtre serveur 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. Dans les deux cas, le formulaire s'ouvre dans la fenêtre filtre serveur par formulaire.

Vous pouvez uniquement supprimer un filtre serveur à l’aide de Visual Basic pour définir la propriété ServerFilterByForm sur False ou effacer tous les critères de filtre dans la fenêtre Filtrer par formulaire du serveur, puis choisir Appliquer le filtre serveur.

Lorsque la propriété ServerFilter est définie en mode Création de formulaire, Microsoft Access n'essaie pas de valider l'expression SQL. Si l'expression SQL n'est pas valide, une erreur se produit lorsque le filtre est appliqué.

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.