NamedRange.AutoFilter, méthode

  • Article

Filtre une liste à l'aide du filtrage automatique.

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

Syntaxe

'Déclaration
Function AutoFilter ( _
    Field As Object, _
    Criteria1 As Object, _
    Operator As XlAutoFilterOperator, _
    Criteria2 As Object, _
    VisibleDropDown As Object _
) As Object

Object AutoFilter(
    Object Field,
    Object Criteria1,
    XlAutoFilterOperator Operator,
    Object Criteria2,
    Object VisibleDropDown
)

Paramètres

  • Field
    Type : System.Object
    Offset du champ sur lequel vous souhaitez baser le filtre (à partir de la gauche de la liste, le champ à l'extrême gauche est le champ 1).
  • Criteria1
    Type : System.Object
    Critères (chaîne, par exemple "101").Utilisez "=" pour rechercher des champs vides ou "<>" pour rechercher des champs non vides.Si cet argument est omis, le critère est All.Si Operator est xlTop10Items, Criteria1 spécifie le nombre d'éléments (par exemple, "10").
  • Criteria2
    Type : System.Object
    Deuxième critère (chaîne).Utilisé avec Criteria1 et Operator pour construire des critères composés.
  • VisibleDropDown
    Type : System.Object
    true pour afficher la flèche de déroulement Filtre automatique du champ filtré ; false pour masquer la flèche de déroulement Filtre automatique du champ filtré.Par défaut, true.

Valeur de retour

Type : System.Object

Notes

Si vous omettez tous les arguments, cette méthode bascule simplement l'affichage des flèches de déroulement Filtre automatique dans le contrôle NamedRange.

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 affecte cinq chaînes de noms différentes aux cellules A1 à A5, puis utilise la méthode AutoFilter pour filtrer sur le nom "Robert".

Cet exemple illustre une personnalisation au niveau du document.

    Private Sub SetAutoFilter()
        Me.Range("A1").Value2 = "Kathleen"
        Me.Range("A2").Value2 = "Robert"
        Me.Range("A3").Value2 = "Paul"
        Me.Range("A4").Value2 = "Harry"
        Me.Range("A5").Value2 = "George"

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

        namedRange1.AutoFilter(1, "Robert", _
            Excel.XlAutoFilterOperator.xlAnd, , True)
    End Sub


private void SetAutoFilter()
{
    this.Range["A1"].Value2 = "Kathleen";
    this.Range["A2"].Value2 = "Robert";
    this.Range["A3"].Value2 = "Paul";
    this.Range["A4"].Value2 = "Harry";
    this.Range["A5"].Value2 = "George";

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

    namedRange1.AutoFilter(1, "Robert",
        Excel.XlAutoFilterOperator.xlAnd, true);
}

Sécurité .NET Framework

Voir aussi

Référence

NamedRange Interface

Microsoft.Office.Tools.Excel, espace de noms