Propriété PremièresValeurs

Vous pouvez utiliser la propriété PremièresValeurs pour renvoyer un nombre spécifié ou un pourcentage d’enregistrements répondant aux critères que vous spécifiez. Par exemple, il se peut que vous souhaitiez renvoyer les 10 premières valeurs des 25 pour cent supérieurs de toutes les valeurs dans un champ.

Remarque : La propriété PremièresValeurs s’applique uniquement aux requêtes Ajout, Création de table et Sélection.

Paramètre

La définition de propriété PremièresValeurs est une valeur de nombre entier représentant le nombre exact de valeurs à renvoyer, ou un nombre suivi du signe de pourcentage (%) représentant le pourcentage d’enregistrements à renvoyer. Par exemple, pour renvoyer les 10 premières valeurs, définissez la propriété PremièresValeurs sur 10, et pour renvoyer les 10 % de premières valeurs, définissez la propriété PremièresValeurs sur 10 %.

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

Vous pouvez également définir la propriété PremièresValeurs à l’aide de la feuille de propriétés de la requête ou de la zone Premières valeurs sous Outils sous l’onglet Création.

Remarque : La propriété PremièresValeurs dans la feuille de propriétés de la requête et sous l’onglet Création est une zone de liste modifiable de valeurs et de valeurs de pourcentage. Vous pouvez sélectionner l’une de ces valeurs ou taper n’importe quel paramètre valide dans la zone.

Remarques

En règle générale, vous utilisez la définition de propriété PremièresValeurs conjointement avec des champs triés. Le champ pour lequel vous voulez afficher les premières valeurs doit être le champ le plus à gauche dont la zone Trier est sélectionnée dans la grille de création de la requête. Un tri croissant renvoie les enregistrements dont les valeurs sont les plus basses, et un tri décroissant ceux dont les valeurs sont les plus élevées. Si vous spécifiez de renvoyer un nombre spécifique d’enregistrements, tous les enregistrements dont la valeur correspond à celle du dernier enregistrement sont également renvoyées.

Par exemple, supposons qu’un ensemble d’employés ait les totaux de ventes suivants.

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é PremièresValeurs sur 3 avec un tri décroissant sur le champ Sales (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 valeurs les plus élevées ou les plus basses sans afficher les valeurs en double, définissez la propriété ValeursDistinctes dans la feuille de propriétés de la requête sur Oui.

Exemple

L’exemple suivant assigne une chaîne SQL qui renvoie les 10 produits les plus chers à la propriété Source pour un formulaire qui affiche les dix produits les plus coûteux.

Dim strGetSQL As String
strGetSQL = "SELECT TOP 10 Products.[ProductName] " _
& "AS TenMostExpensiveProducts, " _
& "Products.UnitPrice " _
& "FROM Products " _
& "ORDER BY Products.[UnitPrice] DESC;"
Me.RecordSource = strGetSQL
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.

×