NamedRange.AutoFilter, méthode

Article
08/10/2011

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").

Operator
Type : Microsoft.Office.Interop.Excel.XlAutoFilterOperator
Il peut s'agir de l'une des constantes XlAutoFilterOperator suivantes :
xlAnd
xlBottom10Items
xlBottom10Percent
xlOr
xlTop10Items
xlTop10Percent
Utilisez xlAnd et xlOr avec Criteria1 et Criteria2 pour construire des critères composés.

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", missing].Value2 = "Kathleen";
    this.Range["A2", missing].Value2 = "Robert";
    this.Range["A3", missing].Value2 = "Paul";
    this.Range["A4", missing].Value2 = "Harry";
    this.Range["A5", missing].Value2 = "George";

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

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

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

NamedRange Interface

Microsoft.Office.Tools.Excel, espace de noms

Partager via