NamedRange.AutoFilter - метод

Статья
08/11/2011

Фильтрует список с использованием автофильтра.

Пространство имен: 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 - пространство имен

Поделиться через