Почему фильтры ClosedXML не работают в существующих файлах Excel

Чаще всего проблема в том, что в уже сохранённой книге присутствуют старые параметры AutoFilter или неконсистентные данные (даты/числа/локаль), и ClosedXML при открытии не перезаписывает/не привязывает новые условия так, как при создании нового файла. Исправление: очистить существующий автофильтр (worksheet.AutoFilter.Clear() или worksheet.SetAutoFilter(false)), правильно задать диапазон/таблицу (RangeUsed().SetAutoFilter() или работа с IXLTable), убедиться, что типы данных корректны, и при необходимости обновить ClosedXML до версии с исправлениями.

Содержание

• Краткий диагноз и суть проблемы
• Почему фильтры не применяются в существующих файлах (ClosedXML)
• Как правильно применять фильтры к существующим файлам в ClosedXML (C#)
• Практический пример: рабочий код для существующего файла
• Диагностика: чеклист и распространённые ошибки
• Советы по версиям, локали и типам данных
• Источники
• Заключение

Краткий диагноз и суть проблемы

Вы создаёте фильтр в свежем файле — всё работает. Открываете существующий файл и применяете те же вызовы — Excel не показывает строки, пока вы не нажмёте “Reapply” вручную. Почему так? Потому что в файле уже может быть сохранённое состояние AutoFilter (или таблица/listobject) с параметрами, которые Excel/ClosedXML не «перепривязывает» автоматически; кроме того, старые XML-элементы, локаль чисел или неправильная сериализация дат могут мешать применению фильтра.

Коротко: либо старый AutoFilter нужно сбросить, либо надо работать с существующей таблицей корректно, либо обновить библиотеку (там были баги с датами и локалями). См. примеры и обсуждения в документации и репозитории проекта для подтверждения решения.

Почему фильтры не применяются в существующих файлах (ClosedXML)

Ниже перечислены реальные причины, с которыми сталкиваются разработчики:

• Существующий AutoFilter не перезаписывается. В книге может уже быть AutoFilter на том же листе или в table; ClosedXML не перезапишет корректно старый фильтр — его нужно явно очистить (ws.AutoFilter.Clear() или ws.SetAutoFilter(false)). Подробнее — пример создания/удаления фильтра в гайде: Adding an AutoFilter to a Range.

• Дублирование экземпляров книги / порядок Save/Dispose. Если у вас в коде создаётся несколько экземпляров XLWorkbook для одного и того же файла, состояние фильтра может не записаться корректно; в похожей проблеме решение было в использовании одного экземпляра и явной очистке фильтра перед применением новых условий — см. обсуждение на StackOverflow: ClosedXML filters do not work with opened files.

• Неправильная сериализация дат/чисел. Ранее были баги, когда фильтр по колонке с датами не показывал строки при открытии в Excel, пока не нажать Reapply — исправления внесены в поздние версии ClosedXML; пример бага и обсуждение: Issue #701. Также проблемы с локалью (тысячные разделители) описаны в Issue #990.

• Конфликт фильтра и таблицы (table + AutoFilter). В некоторых случаях некорректные или устаревшие XML-элементы в таблице приводят к тому, что при открытии Excel удаляет AutoFilter/таблицу во время восстановления файла — пример: Issue #1213.

• Неправильный диапазон или заголовки. RangeUsed() может вернуть не тот диапазон (например, если есть пустые строки/столбцы), и AutoFilter навешивается не на то, что вы ожидаете. Всегда проверяйте, что диапазон включает строку заголовков.

Как правильно применять фильтры к существующим файлам в ClosedXML (C#)

Шаблонный порядок действий, который решает большинство проблем:

1. Открыть книгу одним экземпляром:

• using (var wb = new XLWorkbook(path))

2. Найти лист:

• var ws = wb.Worksheet(“Sheet1”);

3. Очистить старый автофильтр (если есть):

• ws.AutoFilter?.Clear();
• или ws.SetAutoFilter(false);

4. Определить корректный диапазон с заголовком:

• var range = ws.RangeUsed();
• при сомнениях — явно указать диапазон: ws.Range(“A1:B100”).

5. Установить AutoFilter заново:

• range.SetAutoFilter();

6. Применить фильтры по колонкам:

• ws.AutoFilter.Column(1).EqualTo(“ValueA”);
• или для таблицы: table.AutoFilter.Column(3).AddFilter(“FilterValue”);

7. Убедиться в корректных типах данных:

• Даты — записывать как DateTime, числа — как числовые значения, не как строки.

8. Сохранить книгу (и корректно закрыть объект):

• wb.Save(); или wb.SaveAs(…); затем выход из using-блока.

Почему важно очищать фильтр первым? Потому что при наличии старого AutoFilter ClosedXML/Excel могут оставлять старые критерии в XML, и новые условия не будут видны в UI до Reapply.

Пример: при наличии таблицы (IXLTable) предпочтительнее работать с ней — это даёт более предсказуемое поведение фильтров.

Практический пример: рабочий код для существующего файла

Ниже — компактный, практичный пример, который учитывает очистку старого фильтра и работу с таблицей:

using System.Linq;
using ClosedXML.Excel;

public void ApplyFilterToExisting(string path)
{
 using (var wb = new XLWorkbook(path))
 {
 var ws = wb.Worksheet(1);

 // 1. Сбросить существующий AutoFilter (без исключений если его нет)
 ws.AutoFilter?.Clear();

 // 2. Получить используемый диапазон (с заголовком)
 var range = ws.RangeUsed();
 if (range == null)
 {
 wb.Save();
 return;
 }

 // 3. Работать с таблицей, если она есть, иначе создать
 var table = ws.Tables.FirstOrDefault() ?? range.CreateTable();

 // 4. Убедиться, что у таблицы включён AutoFilter
 table.ShowAutoFilter = true;

 // 5. Пример: фильтр по первой колонке (индекс начинается с 1)
 table.AutoFilter.Column(1).Clear();
 table.AutoFilter.Column(1).AddFilter("ValueA");

 // 6. Для даты: используйте DateTime (не строку)
 // table.AutoFilter.Column(3).EqualTo(new DateTime(2021, 1, 1));

 wb.Save();
 }
}

Ключевые моменты: явная очистка ws.AutoFilter, работа через IXLTable при наличии таблицы, сохранение книги только после установки фильтров.

Диагностика: чеклист и распространённые ошибки

Если фильтр всё ещё не работает — проверьте по чеклисту:

• Есть ли в файле уже AutoFilter или таблица? (ws.AutoFilter != null; ws.Tables.Any())
• Создаёте ли вы случайно второй экземпляр XLWorkbook для того же файла? Уберите дубли.
• Присваиваете ли вы датам/числам правильные типы (DateTime, double), а не строки?
• Правильно ли выбран диапазон заголовков (RangeUsed() включает заголовки)?
• Сохраняете ли вы книгу после изменений?
• Попробуйте очистить фильтр и сохранить -> открыть в Excel -> проверить. Если после ручной Reapply всё работает — значит проблема сериализации/локали.
• Проверьте версию ClosedXML — баги по датам/локали фиксились в поздних релизах.

Если нужно — минимизируйте пример: создайте копию существующего файла, удалите всё лишнее (таблицы/стили/фильтры) и попробуйте применить фильтр заново — так вы локализуете источник проблемы.

Советы по версиям, локали и типам данных

• Обновите ClosedXML до последней стабильной версии — многие баги, связанные с датами и фильтрами, уже исправлены (см. Issue #701).
• Для чисел и дат всегда записывайте значения в правильном типе (DateTime / numeric). Это убирает проблемы с локалью и разделителями (см. Issue #990).
• Если файл содержит сложные таблицы, стили или был создан сторонним инструментом, очищайте AutoFilter и создавайте фильтр заново — это безопаснее, чем пытаться изменять старые XML-элементы.
• Если вы на входе получаете строки вида “1 000,00” или “01.02.2020”, парсите и переводите в числовой/DateTime формат до записи в ячейку.

Источники

• AutoFilter — ClosedXML 0.102.0 documentation
• Adding an AutoFilter to a Range · ClosedXML/ClosedXML Wiki
• ClosedXML filters do not work with opened files — Stack Overflow
• Issue #701 · ClosedXML/ClosedXML
• Issue #990 · ClosedXML/ClosedXML
• Новые вопросы с меткой [closedxml] — Stack Overflow на русском
• ClosedXML Excel filter rows by values in multiple columns — Stack Overflow
• Issue #1213 · ClosedXML/ClosedXML

Заключение

Коротко: при работе с существующими файлами проблема чаще всего в старом AutoFilter, некорректных типах данных или в известных багах сериализации; решение — явно очистить фильтр, установить диапазон/таблицу заново, гарантировать корректные типы (даты/числа) и, при необходимости, обновить ClosedXML. После этого фильтры в closedxml excel будут применяться так же надёжно, как в новых файлах.