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

.NET Framework 安全性

请参见

参考

NamedRange 接口

Microsoft.Office.Tools.Excel 命名空间