通过

NamedRange.AutoFilter 方法

  • 项目

使用“自动筛选”筛选列表。

命名空间：  Microsoft.Office.Tools.Excel
程序集：  Microsoft.Office.Tools.Excel（在 Microsoft.Office.Tools.Excel.dll 中）

语法

声明
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
)

参数

  • Field
    类型：System.Object
    要使筛选器基于的字段的偏移量（从列表的左边算起；最左边的字段为字段 1（一））。
  • Criteria1
    类型：System.Object
    条件（一个字符串；例如“101”）。使用“=”查找空字段，或者使用“<>”查找非空字段。如果省略此参数，则条件为 All。如果 Operator 为 xlTop10Items，则 Criteria1 指定项数（如“10”）。
  • Criteria2
    类型：System.Object
    第二个条件（字符串）。与 Criteria1 和 Operator 一起使用来构造复合条件。
  • VisibleDropDown
    类型：System.Object
    如果对所筛选字段显示自动筛选下拉箭头，则为 true；如果对所筛选字段隐藏自动筛选下拉箭头，则为 false。默认为 true。

返回值

类型：System.Object

备注

如果您省略所有的参数，则此方法只是切换 NamedRange 控件中自动筛选下拉箭头的显示。

可选参数

有关可选参数的信息，请参见Office 解决方案中的可选参数。

示例

下面的代码示例将单元格 A1 至 A5 设置为五个不同的名称字符串，然后使用 AutoFilter 方法筛选名称“Robert”。

此示例针对的是文档级自定义项。

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

.NET Framework 安全性

请参见

参考

NamedRange 接口

Microsoft.Office.Tools.Excel 命名空间