NamedRange.SortSpecial 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.

Utilise des méthodes de tri d'Asie de l'Est pour trier le contrôle NamedRange. Par exemple, le japonais trie dans l'ordre du syllabaire kana. Pour plus d'informations, consultez la liste des paramètres.

public object SortSpecial (Microsoft.Office.Interop.Excel.XlSortMethod SortMethod = Microsoft.Office.Interop.Excel.XlSortMethod.xlPinYin, object Key1, Microsoft.Office.Interop.Excel.XlSortOrder Order1 = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, object Type, object Key2, 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.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 SortSpecial : Microsoft.Office.Interop.Excel.XlSortMethod * 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.XlSortDataOption * Microsoft.Office.Interop.Excel.XlSortDataOption * Microsoft.Office.Interop.Excel.XlSortDataOption -> obj

Public Function SortSpecial (Optional SortMethod As XlSortMethod = Microsoft.Office.Interop.Excel.XlSortMethod.xlPinYin, Optional Key1 As Object, Optional Order1 As XlSortOrder = Microsoft.Office.Interop.Excel.XlSortOrder.xlAscending, Optional Type As Object, Optional Key2 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 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

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 (par défaut). Ordre de tri du chinois phonétique pour les caractères.

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 (valeur par défaut). Trie Key1 dans l’ordre croissant.

Type: Object

Spécifie quels éléments doivent être triés. Utilisez cet argument uniquement lors du tri de rapports PivotTable.

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. Ne peut pas être utilisé lors du tri de rapports PivotTable.

Order2: XlSortOrder

Ordre de tri du champ ou de la plage spécifié dans l’argument 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 (valeur par défaut). 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 du champ ou de la plage spécifié dans l’argument 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 (valeur par défaut). 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 (par défaut). 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, l’ordre de 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 (valeur par défaut). Le tri est effectué par ligne. xlSortColumns. Le tri est effectué par colonne.

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. Traite le texte comme des données numériques pour le tri. xlSortNormal (par défaut). 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 (par défaut). 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 (par défaut). Trie les données numériques et les données textuelles séparément.

Retours

Object

Exemples

L’exemple de code suivant utilise la SortSpecial méthode pour trier un NamedRange à l’aide de Pin Yin (ordre de tri chinois phonétique pour les caractères). Pour trier les caractères chinois, cet exemple suppose que l’utilisateur dispose d’une prise en charge de la langue chinoise pour Microsoft Office Excel. Excel trie par défaut la NamedRange valeur par si l’utilisateur ne prend pas en charge la langue chinoise.

Cet exemple concerne une personnalisation au niveau du document.

private void SortSpecialNamedRange()
{
    this.Range["A1"].Value2 = 50;
    this.Range["A2"].Value2 = 10;
    this.Range["A3"].Value2 = 20;
    this.Range["A4"].Value2 = 30;
    this.Range["A5"].Value2 = 40;

    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    namedRange1.SortSpecial(Excel.XlSortMethod.xlPinYin,
        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.XlSortDataOption.xlSortNormal,
        Excel.XlSortDataOption.xlSortNormal,
        Excel.XlSortDataOption.xlSortNormal);

}

Private Sub SortSpecialNamedRange()
    Me.Range("A1").Value2 = 50
    Me.Range("A2").Value2 = 10
    Me.Range("A3").Value2 = 20
    Me.Range("A4").Value2 = 30
    Me.Range("A5").Value2 = 40

    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
        "namedRange1")

    namedRange1.SortSpecial(Excel.XlSortMethod.xlPinYin, _
        Me.Range("A1", "A5"), Excel.XlSortOrder.xlAscending, , , _
        Excel.XlSortOrder.xlAscending, , _
        Excel.XlSortOrder.xlAscending, _
        Excel.XlYesNoGuess.xlNo, , , _
        Excel.XlSortOrientation.xlSortColumns, _
        Excel.XlSortDataOption.xlSortNormal, _
        Excel.XlSortDataOption.xlSortNormal, _
        Excel.XlSortDataOption.xlSortNormal)
End Sub

Remarques

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 à

Partager via