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”）。

• Operator
  类型：Microsoft.Office.Interop.Excel.XlAutoFilterOperator
  可以是下列 XlAutoFilterOperator 常量之一：
  xlAnd
  xlBottom10Items
  xlBottom10Percent
  xlOr
  xlTop10Items
  xlTop10Percent
  使用 xlAnd 和 xlOr 以及 Criteria1 和 Criteria2 来构造复合条件。

• 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 命名空间