NamedRange.SortSpecial, méthode

  • Article

Utilise des méthodes de tri d'Extrême-Orient 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.

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

Syntaxe

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

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

Paramètres

  • SortMethod
    Type : Microsoft.Office.Interop.Excel.XlSortMethod
    Type de tri.Certaines de ces constantes peuvent ne pas être disponibles pour vous, selon la prise en charge linguistique (Anglais.. américain, par exemple) que vous avez sélectionné ou installé.
    Il peut s'agir de l'une des valeurs XlSortMethod suivantes :
    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.
  • Type
    Type : System.Object
    Spécifie quels éléments doivent être triés.Utilisez cet argument uniquement lors du tri de rapports PivotTable.
  • Key2
    Type : System.Object
    Deuxiè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 deuxième champ de tri.Ne peut pas être utilisé lors du tri de rapports PivotTable.
  • 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 (par défaut).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, l'ordre de 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.

Valeur de retour

Type : System.Object

Notes

Si aucun argument n'est défini avec cette méthode, Microsoft Office Excel trie 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 utilise la méthode SortSpecial pour trier un NamedRange à l'aide du Pin Yin (ordre de tri du chinois phonétique pour les caractères).Pour trier des caractères chinois, cet exemple suppose que l'utilisateur dispose de la prise en charge linguistique du chinois pour Microsoft Office Excel.Excel triera par défaut NamedRange par valeur si l'utilisateur ne dispose pas de la prise en charge linguistique du chinois.

Cet exemple illustre une personnalisation au niveau du document.

    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


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);

}

Sécurité .NET Framework

Voir aussi

Référence

NamedRange Interface

Microsoft.Office.Tools.Excel, espace de noms