NamedRange.Sort Méthode

Référence

Définition

Espace de noms:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Trie les données d'un contrôle NamedRange.

public object Sort (object Key1, Microsoft.Office.Interop.Excel.XlSortOrder Order1 = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, object Key2, object Type, Microsoft.Office.Interop.Excel.XlSortOrder Order2 = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, object Key3, Microsoft.Office.Interop.Excel.XlSortOrder Order3 = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, Microsoft.Office.Interop.Excel.XlYesNoGuess Header = Microsoft.Office.Interop.Excel.XlYesNoGuess.xlNo, object OrderCustom, object MatchCase, Microsoft.Office.Interop.Excel.XlSortOrientation Orientation = Microsoft.Office.Interop.Excel.XlSortOrientation.xlSortRows, Microsoft.Office.Interop.Excel.XlSortMethod SortMethod = Microsoft.Office.Interop.Excel.XlSortMethod.xlPinYin, Microsoft.Office.Interop.Excel.XlSortDataOption DataOption1 = Microsoft.Office.Interop.Excel.XlSortDataOption.xlSortNormal, Microsoft.Office.Interop.Excel.XlSortDataOption DataOption2 = Microsoft.Office.Interop.Excel.XlSortDataOption.xlSortNormal, Microsoft.Office.Interop.Excel.XlSortDataOption DataOption3 = Microsoft.Office.Interop.Excel.XlSortDataOption.xlSortNormal);

abstract member Sort : obj * Microsoft.Office.Interop.Excel.XlSortOrder * obj * obj * Microsoft.Office.Interop.Excel.XlSortOrder * obj * Microsoft.Office.Interop.Excel.XlSortOrder * Microsoft.Office.Interop.Excel.XlYesNoGuess * obj * obj * Microsoft.Office.Interop.Excel.XlSortOrientation * Microsoft.Office.Interop.Excel.XlSortMethod * Microsoft.Office.Interop.Excel.XlSortDataOption * Microsoft.Office.Interop.Excel.XlSortDataOption * Microsoft.Office.Interop.Excel.XlSortDataOption -> obj

Public Function Sort (Optional Key1 As Object, Optional Order1 As XlSortOrder = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, Optional Key2 As Object, Optional Type As Object, Optional Order2 As XlSortOrder = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, Optional Key3 As Object, Optional Order3 As XlSortOrder = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, Optional Header As XlYesNoGuess = Microsoft.Office.Interop.Excel.XlYesNoGuess.xlNo, Optional OrderCustom As Object, Optional MatchCase As Object, Optional Orientation As XlSortOrientation = Microsoft.Office.Interop.Excel.XlSortOrientation.xlSortRows, Optional SortMethod As XlSortMethod = Microsoft.Office.Interop.Excel.XlSortMethod.xlPinYin, Optional DataOption1 As XlSortDataOption = Microsoft.Office.Interop.Excel.XlSortDataOption.xlSortNormal, Optional DataOption2 As XlSortDataOption = Microsoft.Office.Interop.Excel.XlSortDataOption.xlSortNormal, Optional DataOption3 As XlSortDataOption = Microsoft.Office.Interop.Excel.XlSortDataOption.xlSortNormal) As Object

Paramètres

Key1: Object

Premier champ de tri, sous forme de texte (nom de plage) ou d’objet Range (« Dept » ou Cells(1, 1), par exemple).

Order1: XlSortOrder

Ordre de tri pour le champ ou la plage spécifié dans Key1. Il peut s’agir de l’une des valeurs suivantes XlSortOrder : xlDescending. Trie Key1 dans l’ordre décroissant. xlAscending. Trie Key1 dans l’ordre croissant.

Key2: Object

Deuxième champ de tri, sous la forme de texte (un nom de plage) ou d'un objet Range. Si vous omettez cet argument, il n'y a pas de deuxième champ de tri.

Type: Object

Spécifie quels éléments doivent être triés. Utilisez cet argument uniquement lors du tri des rapports de tableau croisé dynamique. Il peut s’agir de l’une des valeurs suivantes XlSortType : xlSortLabels. Trie le rapport PivotTable par étiquettes. xlSortValues. Trie le rapport PivotTable par valeurs.

Order2: XlSortOrder

Ordre de tri pour la plage spécifiée dans Key2. Ne peut pas être utilisé lors du tri des rapports de tableau croisé dynamique. Il peut s’agir de l’une des valeurs suivantes XlSortOrder : xlDescending. Trie Key2 dans l’ordre décroissant. xlAscending. Trie Key2 dans l’ordre croissant.

Key3: Object

Troisième champ de tri, sous la forme de texte (un nom de plage) ou d'un objet Range. Si vous omettez cet argument, il n'y a pas de troisième champ de tri. Ne peut pas être utilisé lors du tri de rapports PivotTable.

Order3: XlSortOrder

Ordre de tri pour le champ ou la plage spécifié dans Key3. Ne peut pas être utilisé lors du tri des rapports de tableau croisé dynamique. Il peut s’agir de l’une des valeurs suivantes XlSortOrder : xlDescending. Trie Key3 dans l’ordre décroissant. xlAscending. Trie Key3 dans l’ordre croissant.

Header: XlYesNoGuess

Indique si la première ligne contient, ou non, des en-têtes. Ne peut pas être utilisé lors du tri des rapports de tableau croisé dynamique. Il peut s’agir de l’une des valeurs suivantes XlYesNoGuess : xlGuess. Laisse Microsoft Office Excel déterminer s'il y a un en-tête et où il se trouve, le cas échéant. xlNo. (La plage entière doit être triée.) xlYes. (La plage entière ne doit pas être triée.)

OrderCustom: Object

Cet argument est un offset d'entier base 1 pour la liste des ordres de tri personnalisés. Si vous omettez OrderCustom, un tri normal est utilisé.

MatchCase: Object

true pour effectuer un tri respectant la casse ; false pour effectuer un tri ne respectant pas la casse. Ne peut pas être utilisé lors du tri de rapports PivotTable.

Orientation: XlSortOrientation

Orientation de tri. Il peut s’agir de l’une des valeurs suivantes XlSortOrientation : xlSortRows. Effectue le tri par ligne. xlSortColumns. Effectue le tri par colonne.

SortMethod: XlSortMethod

Type de tri. Certaines de ces constantes peuvent ne pas être disponibles, selon la prise en charge linguistique (anglais américain, par exemple) que vous avez sélectionnée ou installée. Il peut s’agir de l’une des valeurs suivantes XlSortMethod : xlStroke. Tri basé sur la quantité de traits dans chaque caractère. xlPinYin. Ordre de tri du chinois phonétique pour les caractères.

DataOption1: XlSortDataOption

Spécifie comment trier du texte dans key1. Ne peut pas être utilisé lors du tri des rapports de tableau croisé dynamique. Il peut s’agir de l’une des valeurs suivantes XlSortDataOption : xlSortTextAsNumbers. Traiter le texte comme des données numériques pour le tri. xlSortNormal. Trie les données numériques et les données textuelles séparément.

DataOption2: XlSortDataOption

Spécifie comment trier du texte dans key2. Ne peut pas être utilisé lors du tri des rapports de tableau croisé dynamique. Il peut s’agir de l’une des valeurs suivantes XlSortDataOption : xlSortTextAsNumbers. Traite le texte comme des données numériques pour le tri. xlSortNormal. Trie les données numériques et les données textuelles séparément.

DataOption3: XlSortDataOption

Spécifie comment trier du texte dans key3. Ne peut pas être utilisé lors du tri des rapports de tableau croisé dynamique. Il peut s’agir de l’une des valeurs suivantes XlSortDataOption : xlSortTextAsNumbers. Traite le texte comme des données numériques pour le tri. xlSortNormal. Trie les données numériques et les données textuelles séparément.

Retours

Object

Exemples

L’exemple de code suivant place un ensemble d’entiers dans les cellules A1 à A5, puis utilise la Sort méthode pour trier les données dans l’ordre croissant.

Cet exemple concerne une personnalisation au niveau du document.

private void SortNamedRange()
{
    // Set some data in a range of cells.
    this.Range["A1"].Value2 = 30;
    this.Range["A2"].Value2 = 10;
    this.Range["A3"].Value2 = 20;
    this.Range["A4"].Value2 = 50;
    this.Range["A5"].Value2 = 40;

    // Create a NamedRange that refers to the range.
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    // Sort the NamedRange.
    namedRange1.Sort(this.Range["A1", "A5"],
        Excel.XlSortOrder.xlAscending,
        missing,
        missing,
        Excel.XlSortOrder.xlAscending,
        missing,
        Excel.XlSortOrder.xlAscending,
        Excel.XlYesNoGuess.xlNo,
        missing,
        missing,
        Excel.XlSortOrientation.xlSortColumns,
        Excel.XlSortMethod.xlStroke,
        Excel.XlSortDataOption.xlSortNormal,
        Excel.XlSortDataOption.xlSortNormal,
        Excel.XlSortDataOption.xlSortNormal);
}

Private Sub SortNamedRange()
    ' Set some data in a range of cells.
    Me.Range("A1").Value2 = 30
    Me.Range("A2").Value2 = 10
    Me.Range("A3").Value2 = 20
    Me.Range("A4").Value2 = 50
    Me.Range("A5").Value2 = 40

    ' Create a NamedRange that refers to the range.
    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
        "namedRange1")

    ' Sort the NamedRange.
    namedRange1.Sort(Me.Range("A1", "A5"), _
        Excel.XlSortOrder.xlAscending, , , _
        Excel.XlSortOrder.xlAscending, , _
        Excel.XlSortOrder.xlAscending, Excel.XlYesNoGuess.xlNo, , , _
        Excel.XlSortOrientation.xlSortColumns, _
        Excel.XlSortMethod.xlStroke, _
        Excel.XlSortDataOption.xlSortNormal, _
        Excel.XlSortDataOption.xlSortNormal, _
        Excel.XlSortDataOption.xlSortNormal)
End Sub

Remarques

Les paramètres de Header, Order1, Order2, Order3OrderCustom, et Orientation sont enregistrés pour la feuille de calcul spécifique chaque fois que vous utilisez cette méthode. Si vous ne spécifiez pas de valeurs pour ces arguments la prochaine fois que vous appelez la méthode, les valeurs enregistrées sont utilisées. Définissez ces arguments explicitement chaque fois que vous utilisez cette méthode, si vous choisissez de ne pas utiliser les valeurs enregistrées.

Les chaînes de texte qui ne sont pas convertibles en données numériques sont triées normalement.

Si aucun argument n’est défini avec cette méthode, Microsoft Office Excel trie la sélection dans l’ordre croissant.

Paramètres facultatifs

Pour plus d’informations sur les paramètres facultatifs, consultez Paramètres facultatifs dans les solutions Office.

S’applique à