Экспорт¶

Начиная с версии 1.2, контрол TreeList может экспортировать данные в формат XLSX (Microsoft Excel).

Замечание

Функциональность экспорта реализована в библиотеке Eremex.DocumentProcessing. Убедитесь, что эта библиотека подключена к вашему проекту, чтобы использовать функцию экспорта.

Экспорт в формат XLSX¶

Движок экспорта в Excel является data-aware, то есть он сохраняет параметры форматирования данных контрола в выходном документе XLSX, включая:

Иерархию узлов
Форматирование значений
Сортировку данных

После экспорта данных вы можете обрабатывать и анализировать их в Microsoft Excel или другом приложении для работы с таблицами.

treelist-export-result

Замечание

Форматирование ячеек, реализованное с помощью шаблонов ячеек (TreeListColumn.CellTemplate), не экспортируется.

Используйте следующие методы для экспорта данных контрола в формат XLSX:

TreeListControl.ExportToXlsx(string fileName, XlsxExportOptions? options = null) — Экспортирует данные в файл.
TreeListControl.ExportToXlsx(Stream stream, XlsxExportOptions? options = null) — Экспортирует данные в поток.

Необязательный параметр options (типа XlsxExportOptions) позволяет настроить параметры экспорта. Класс XlsxExportOptions предоставляет следующие члены:

Событие ExportProgress — Возникает повторно в процессе экспорта данных. Параметр ExportProgressEventArgs.ProgressPercentage события указывает прогресс в процентах (от 0 до 100). Вы можете использовать это событие для отображения прогресса экспорта пользователям своим способом.
Свойство AllowFixedColumnHeaderPanel (по умолчанию true) — Получает или задает, должна ли панель заголовков столбцов оставаться закрепленной вверху в экспортированном документе.
Свойство ApplyFormattingToEntireColumn — Получает или задает, применяется ли форматирование ячеек ко всем столбцам целиком или к отдельным ячейкам в выходном документе.
Свойство AllowGrouping (по умолчанию true) — Получает или задает, экспортируется ли иерархия узлов. Если AllowGrouping равно false, иерархия узлов не сохраняется в выходном документе.
Свойство DocumentCulture — Получает или задает пользовательский объект CultureInfo, который определяет правила форматирования числовых и дата-время значений в выходном документе. Если свойство DocumentCulture не указано, движок экспорта использует текущую культуру приложения.
Свойство ShowBands (по умолчанию null) — Получает или задает, включаются ли диапазоны контрола в экспорт. Если ShowBands равно null, настройка определяется свойством TreeListControl.ShowBands контрола.
Свойство ShowColumnHeaders (по умолчанию null) — Получает или задает, включается ли панель заголовков столбцов в экспорт. Если ShowColumnHeaders равно null, настройка определяется свойством TreeListControl.ShowColumnHeaders контрола.
Свойство ShowHorizontalLines — Получает или задает, видны ли горизонтальные линии между ячейками в выходном документе.
Свойство ShowVerticalLines — Получает или задает, видны ли вертикальные линии между ячейками в выходном документе.
Свойство TextExportMode — Получает или задает режим экспорта по умолчанию для значений ячеек. Доступные варианты:
- TextExportMode.Value — Экспортирует значения ячеек. Если значения ячеек отформатированы в контроле TreeList, движок экспорта пытается применить соответствующее форматирование к экспортированным значениям в выходном документе.
- TextExportMode.Text — Экспортирует отображаемый текст ячеек. Если значения ячеек отформатированы в контроле TreeList, экспортируется строковое представление с форматированием.
Вы можете использовать свойство TreeListColumn.TextExportMode, чтобы переопределить настройку XlsxExportOptions.TextExportMode для отдельных столбцов.
Замечание

Движок экспорта учитывает только форматирование ячеек, примененное с помощью свойства TreeListColumn.EditorProperties. Например:
```
<mxtl:TreeListColumn Width="*" FieldName="Salary">
    <mxtl:TreeListColumn.EditorProperties>
        <mxe:TextEditorProperties DisplayFormatString="c"/>
    </mxtl:TreeListColumn.EditorProperties>
</mxtl:TreeListColumn>
```
Форматирование ячеек, примененное другими способами (например, с помощью TreeListColumn.CellTemplate), игнорируется при экспорте данных.

^* Эта страница была переведена с помощью нейросети Deepseek.