NamedRange.AutoFilter Метод

Определение

Пространство имен:

Microsoft.Office.Tools.Excel

Сборка:

Microsoft.Office.Tools.Excel.dll

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

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

Параметры

Field

Object

Смещение поля, на котором должен быть основан фильтр (с левого конца списка; самым левым полем является поле 1 (один)).

Criteria1

Object

Условие (строка; например «101»). Используйте "=" для поиска пустых полей или воспользуйтесь "<>" для поиска непустых полей. Если этот аргумент не указан, условием является All. Если Operator имеет значение xlTop10Items, Criteria1 указывает количество элементов (например, "10").

Operator

XlAutoFilterOperator

Может быть одной из следующих XlAutoFilterOperator констант: xlAndxlTop10ItemsxlBottom10PercentxlBottom10ItemsxlTop10PercentxlOrи с xlOrxlAndCriteria1 и Criteria2 для создания составных критериев.

Criteria2

Object

Второе условие (строка). Используется с Criteria1 и Operator для создания составных критериев.

VisibleDropDown

Object

Значение true для отображения стрелки раскрывающегося списка автофильтрации; false, чтобы скрыть стрелку раскрывающегося списка автофильтрации в отфильтрованном поле. По умолчанию: true.

Возвращаемое значение

Object

Примеры

В следующем примере кода задается в ячейках A1–A5 пять разных строк имен, а затем используется AutoFilter метод для фильтрации по имени "Robert".

Этот пример предназначен для настройки на уровне документа.

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

Комментарии

Если пропустить все аргументы, этот метод просто переключает отображение стрелки раскрывающегося списка Автофильтр в элементе NamedRange управления .

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.