TopValues, propriété

Important :  Cet article a été traduit automatiquement, voir l’avertissement. Vous pouvez consulter la version en anglais de cet article ici.

La propriété TopValues permet de renvoyer un nombre spécifié ou un pourcentage d'enregistrements qui répondent aux critères spécifiés. Vous pouvez par exemple renvoyer les 10 premières valeurs ou les premiers 25 % de toutes les valeurs d'un champ.

Remarque : La propriété TopValues s’applique uniquement aux requêtes Ajout, création de table et sélection.

Paramètre

La propriété TopValues est une nombre entier représentant le nombre exact de valeurs à renvoyer ou un nombre suivi d’un signe de pourcentage (%) représentant le pourcentage d’enregistrements à retourner. Par exemple, pour renvoyer les 10 premières valeurs, définissez la propriété TopValues sur 10 ; Pour renvoyer les premiers 10 % des valeurs, définissez la propriété TopValues sur 10 %.

Vous ne pouvez pas définir cette propriété directement dans le code. Il est défini dans mode SQL de la fenêtre Requête à l’aide d’un n PREMIERS clause ou TOP n PERCENT dans l’instruction SQL.

Vous pouvez également définir la propriété TopValues par le biais de la feuille des propriétés de la requête ou la zone Premières valeurs sous Outils de l'onglet Création.

Remarque : La propriété TopValues de la feuille des propriétés de la requête et de l'onglet Création est une zone de liste déroulante contenant une liste de valeurs et de pourcentages. Vous pouvez sélectionner l'une de ces valeurs ou entrer un paramètre valide dans la zone.

Remarques

En règle générale, vous utilisez la propriété TopValues avec des champs. Le champ que vous souhaitez afficher les premières valeurs doit être le champ à l’extrême gauche qui comporte la zone Trier sélectionnée dans la grille de création de requête. Un tri croissant renvoie les enregistrements plus bas et un tri décroissant renvoie les premiers enregistrements. Si vous spécifiez renvoyer un nombre spécifique d’enregistrements, tous les enregistrements dont la valeur correspond à la valeur du dernier enregistrement sont également renvoyés.

Par exemple, supposez qu'une équipe d'employés ait atteint les sommes de ventes totales suivantes.

Ventes

Vendeur

90 000

Leverling

80 000

Peacock

70 000

Davolio

70 000

King

60 000

Suyama

50 000

Buchanan


Si vous définissez la propriété TopValues sur 3 avec un tri décroissant sur le champ Ventes, Microsoft Office Access 2007 renvoie les quatre enregistrements suivants.

Ventes

Vendeur

90 000

Leverling

80 000

Peacock

70 000

Davolio

70 000

King


Remarque : Pour renvoyer les premières et les dernières valeurs sans afficher les doublons, définissez la propriété UniqueValues dans la feuille des propriétés sur Oui.

Exemple

L'exemple suivant affecte une chaîne SQL qui renvoie les 10 produits les plus chers à la propriété RecordSource d'un formulaire qui affichera les dix produits les plus chers.

Dim strGetSQL As String
strGetSQL = "SELECT TOP 10 Products.[ProductName] " _
& "AS TenMostExpensiveProducts, " _
& "Products.UnitPrice " _
& "FROM Products " _
& "ORDER BY Products.[UnitPrice] DESC;"
Me.RecordSource = strGetSQL

Remarque : Avertissement traduction automatique : cet article a été traduit par un ordinateur, sans intervention humaine. Microsoft propose cette traduction automatique pour offrir aux personnes ne maîtrisant pas l’anglais l’accès au contenu relatif aux produits, services et technologies Microsoft. Comme cet article a été traduit automatiquement, il risque de contenir des erreurs de grammaire, de syntaxe ou de terminologie.

Développez vos compétences
Découvrez des formations
Accédez aux nouvelles fonctionnalités en avant-première
Rejoignez le programme Office Insider

Ces informations vous ont-elles été utiles ?

Nous vous remercions pour vos commentaires.

Merci pour vos commentaires. Il serait vraisemblablement utile pour vous de contacter l’un de nos agents du support Office.

×