Partager via

Filtrage des éléments

  • Article

Cette rubrique décrit les règles générales à observer pour spécifier des propriétés dans les filtres pris en charge par divers objets d'Outlook. Pour plus d’informations sur la spécification de conditions sur les propriétés pour terminer un filtre, consultez les rubriques de la section Syntaxe de filtre .

Un filtre est une condition ou un ensemble de conditions que vous pouvez appliquer à un ensemble d’éléments pour obtenir un sous-ensemble d’éléments qui répondent aux conditions spécifiées. Outlook prend en charge les filtres à l’aide de la syntaxe du langage de requête Microsoft Jet ou de la syntaxe DASL (DAV Searching and Locating). Notez que la syntaxe de langage de requête Jet est identique à celle prise en charge par Microsoft Jet Expression Service, d’où le nom de langage de requête Jet.

Par exemple, vous pouvez filtrer les éléments de contact présents dans votre dossier Contacts pour obtenir la liste des contacts résidant au Canada. Dans ce cas, vous allez filtrer sur la propriété HomeAddressCountry . Le filtre, exprimé sous la forme d’un filtre Jet, sera "[HomeAddressCountry] = 'Canada'".

Outlook fournit un filtrage via les points d'entrée suivants :

Point d’entrée Prise en charge du filtre jet Prise en charge des filtres DASL
Application.AdvancedSearch Non Oui
Folder.GetTable Oui Oui
Items.Find Oui Oui. Notez que si vous utilisez les mots clés de requête ci_phrasematch ou ci_startswith dans le filtre, vous obtiendrez une erreur.
Items.Restrict Oui Oui
Search.GetTable Non Oui
Table.FindRow Oui Oui. Notez que si vous utilisez les mots clés de requête ci_phrasematch ou ci_startswith dans le filtre, vous obtiendrez une erreur.
Table.Restrict Oui Oui
View.Filter Non Oui

Remarque

Un filtre doit contenir une requête utilisant la syntaxe Jet ou DASL, mais pas une combinaison des deux.

Spécificateurs de propriété

Lorsque vous spécifiez des propriétés dans un filtre Jet ou DASL à l’aide de l’un des points d’entrée ci-dessus, suivez ces instructions.

Filtre à jet Filtre DASL
Propriétés applicables La plupart des propriétés intégrées explicites et personnalisées au niveau de l'élément ; voir dans la rubrique traitant de la méthode correspondante quelles sont les propriétés non prises en charge. La plupart des propriétés intégrées et personnalisées au niveau de l'élément avec et sans nom de chaîne explicite ; voir dans la rubrique traitant de la méthode correspondante quelles sont les propriétés non prises en charge.
Référencement des propriétés

  • Par leur nom de chaîne explicite.

  • Les propriétés intégrées explicites ne peuvent être référencées que par leur nom anglais et pas celui d'une autre version linguistique.

  • Les propriétés personnalisées peuvent être référencées par leur nom en anglais ou dans une langue localisée.

 Par leur espace de noms.
Format de référence

  • Les noms de chaînes explicites doivent être entre crochets ('['']').

  • Les noms de propriétés ne respectent pas la casse.

  • Les espaces ne sont pas autorisés dans les propriétés intégrées explicites.

  • Les espaces ne sont pas autorisés dans les propriétés personnalisées.

  • Toutes les requêtes DASL commencent par le préfixe sensible à la casse « @SQL= », à l'exception des requêtes DASL associées à Application.AdvancedSearch.

  • La propriété référencée par un espace de noms doit être entre guillemets.

  • La propriété référencée par l’espace de noms respecte la casse.

  • Si le nom d'une propriété personnalisée contient un espace, celui-ci doit être remplacé par « %20 ». En général, l’encodage d’URL s’applique de la même façon aux caractères d’une requête DASL que dans une URL.
Conditions d’erreur Renvoie une erreur si une propriété personnalisée n'est pas définie dans le filtre, si le filtre est vide, s'il contient un argument non valide ou s'il ne peut pas être analysé. Renvoie une erreur si une propriété personnalisée n'est pas définie dans le filtre, si le filtre est vide, s'il contient un argument non valide ou s'il ne peut pas être analysé.

Syntaxe de filtre

La syntaxe d'un filtre dépend du type de la propriété visée par le filtre. Les rubriques suivantes fournissent des informations supplémentaires sur la façon de construire un filtre basé sur un type de propriété spécifique :

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.