Méthode SortFields.Add (Excel)

Crée un champ de tri et renvoie un objet SortFields.

Syntaxe

expression. Add (Key, SortOn, Order, CustomOrder, DataOption)

expression Variable qui représente un objet SortFields .

Paramètres

Nom	Requis/Facultatif	Type de données	Description
Clé	Obligatoire	Range	Spécifie une valeur de clé pour le tri.
SortOn	Facultatif	Variant	Valeur XlSortOn qui spécifie la propriété d’une cellule à utiliser pour le tri.
Order	Facultatif	Variant	Valeur XlSortOrder qui spécifie l’ordre de tri.
CustomOrder	Facultatif	Variant	Indique si un ordre de tri personnalisé doit être utilisé.
DataOption	Facultatif	Variante	Valeur XlSortDataOption qui spécifie comment trier le texte.

Valeur renvoyée

SortField

Remarques

Cette API n’inclut pas la prise en charge des types de données, tels que Geography ou Stocks. Pour définir un ordre de tri basé sur un sous-champ de l’un de ces types, consultez la méthode Add2 .

Exemple

Cet exemple montre comment trier une table Table1 sur la feuille Sheet1 par colonne1 dans l’ordre croissant.

La méthode Clear est appelée avant pour s’assurer que le tri précédent est effacé afin qu’un nouveau tri puisse être appliqué.

L’objet Sort est appelé pour appliquer le tri ajouté à Table1.

ActiveWorkbook.Worksheets("Sheet1").ListObjects("Table1").Sort.SortFields.Clear
ActiveWorkbook.Worksheets("Sheet1").ListObjects("Table1").Sort.SortFields.Add _
 Key:=Range("Table1[[#All],[Column1]]"), _
 SortOn:=xlSortOnValues, _
 Order:=xlAscending, _
 DataOption:=xlSortNormal
With ActiveWorkbook.Worksheets("Sheet1").ListObjects("Table1").Sort
 .Header = xlYes
 .MatchCase = False
 .Orientation = xlTopToBottom
 .SortMethod = xlPinYin
 .Apply
End With

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.