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

Filtre une liste à l'aide du filtrage automatique.

public object AutoFilter (object Field, object Criteria1, Microsoft.Office.Interop.Excel.XlAutoFilterOperator Operator = Microsoft.Office.Interop.Excel.XlAutoFilterOperator.xlAnd, object Criteria2, object VisibleDropDown);

abstract member AutoFilter : obj * obj * Microsoft.Office.Interop.Excel.XlAutoFilterOperator * obj * obj -> obj

Public Function AutoFilter (Optional Field As Object, Optional Criteria1 As Object, Optional Operator As XlAutoFilterOperator = Microsoft.Office.Interop.Excel.XlAutoFilterOperator.xlAnd, Optional Criteria2 As Object, Optional VisibleDropDown As Object) As Object

Paramètres

Field: 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: Object

Critères (chaîne, par exemple "101"). Utilisez « = » pour rechercher des champs vides, ou utilisez « <> » 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: XlAutoFilterOperator

Il peut s’agir de l’une des constantes suivantes XlAutoFilterOperator :xlOr xlBottom10Percent xlTop10Items xlAnd xlBottom10Items xlTop10Percent utilisez xlAnd et xlOr avec Criteria1 et Criteria2 pour construire des critères composés.

Criteria2: Object

Deuxième critère (chaîne). Utilisé avec Criteria1 et Operator pour construire des critères composés.

VisibleDropDown: 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é. true par défaut.

Retours

Object

Exemples

L’exemple de code suivant définit les cellules A1 à A5 sur cinq chaînes de noms différentes, puis utilise la AutoFilter méthode pour filtrer le nom "Robert".

Cet exemple concerne une personnalisation au niveau du document.

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

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

Remarques

Si vous omettez tous les arguments, cette méthode désactive simplement l’affichage des flèches déroulantes du filtre automatique dans le NamedRange contrôle.

Paramètres facultatifs

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

S’applique à