NamedRange.Sort, méthode

  • Article

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

Espace de noms :  Microsoft.Office.Tools.Excel
Assembly :  Microsoft.Office.Tools.Excel (dans Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Déclaration
Function Sort ( _
    Key1 As Object, _
    Order1 As XlSortOrder, _
    Key2 As Object, _
    Type As Object, _
    Order2 As XlSortOrder, _
    Key3 As Object, _
    Order3 As XlSortOrder, _
    Header As XlYesNoGuess, _
    OrderCustom As Object, _
    MatchCase As Object, _
    Orientation As XlSortOrientation, _
    SortMethod As XlSortMethod, _
    DataOption1 As XlSortDataOption, _
    DataOption2 As XlSortDataOption, _
    DataOption3 As XlSortDataOption _
) As Object

Object Sort(
    Object Key1,
    XlSortOrder Order1,
    Object Key2,
    Object Type,
    XlSortOrder Order2,
    Object Key3,
    XlSortOrder Order3,
    XlYesNoGuess Header,
    Object OrderCustom,
    Object MatchCase,
    XlSortOrientation Orientation,
    XlSortMethod SortMethod,
    XlSortDataOption DataOption1,
    XlSortDataOption DataOption2,
    XlSortDataOption DataOption3
)

Paramètres

  • Type
    Type : System.Object
    Spécifie quels éléments doivent être triés.Utilisez cet argument uniquement lors du tri de rapports PivotTable.
    Il peut s'agir de l'une des valeurs XlSortType suivantes :
    xlSortLabels.Trie le rapport PivotTable par étiquettes.
    xlSortValues.Trie le rapport PivotTable par valeurs.
  • Key3
    Type : System.Object
    Troisième champ de tri, sous la forme de texte (un nom de plage) ou d'un objet Microsoft.Office.Interop.Excel.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.
  • Header
    Type : Microsoft.Office.Interop.Excel.XlYesNoGuess
    Indique si la première ligne contient, ou non, des en-têtes.Ne peut pas être utilisé lors du tri de rapports PivotTable.
    Il peut s'agir de l'une des valeurs XlYesNoGuess suivantes :
    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
    Type : System.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
    Type : System.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.
  • SortMethod
    Type : Microsoft.Office.Interop.Excel.XlSortMethod
    Type de tri.Certaines de ces constantes peuvent ne pas être disponibles, selon la prise en charge linguistique (anglais des États-Unis, par exemple) que vous avez sélectionnée ou installée.
    Il peut s'agir de l'une des valeurs XlSortMethod suivantes :
    xlStroke.Tri basé sur la quantité de traits dans chaque caractère.
    xlPinYin.Ordre de tri du chinois phonétique pour les caractères.

Valeur de retour

Type : System.Object

Notes

Les paramètres de Header, Order1, Order2, Order3, OrderCustom 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 explicitement ces arguments chaque fois 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 triera la sélection dans l'ordre croissant.

Paramètres optionnels

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

Exemples

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

Cet exemple illustre une personnalisation au niveau du document.

    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


private void SortNamedRange()
{
    // Set some data in a range of cells.
    this.Range["A1", missing].Value2 = 30;
    this.Range["A2", missing].Value2 = 10;
    this.Range["A3", missing].Value2 = 20;
    this.Range["A4", missing].Value2 = 50;
    this.Range["A5", missing].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);
}

Sécurité .NET Framework

Voir aussi

Référence

NamedRange Interface

Microsoft.Office.Tools.Excel, espace de noms