Экспорт¶

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

Обратите

Include the Eremex.DocumentProcessing library in your project to use the export feature.

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

Механизм экспорта Excel работает с данными, что означает, что он сохраняет опции формирования данных таблицы в выходном Документе XLSX, включая:

Группировка строк
Форматирование значений
Сортировка данных

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

datagrid-export-result

Обратите

Cell formatting implemented using cell templates (GridColumn.CellTemplate) is not exported.

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

DataGridControl.ExportToXlsx(строковое имя файла, XlsxExportOptions? опции = null) — Экспортирует данные в файл.
DataGridControl.ExportToXlsx(поток stream, XlsxExportOptions? опции = null) — Экспортирует данные в поток.

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

Событие ExportProgress — повторяется во время экспорта данных. Параметр события ExportProgressEventArgs.ProgressPercentage указывает прогресс в процентах (от 0 до 100). Это событие можно использовать для отображения прогресса экспорта пользователям в настраиваемом виде.
Свойство AllowFixedColumnHeaderPanel (по умолчанию — true) - Возвращает или устанавливает, остается ли панель заголовка столбца фиксированной вверху в экспортируемом Документе.
ApplyFormattingToEntireColumn — Получает или устанавливает, применяется ли форматирование ячеек ко всем столбцам или отдельным ячейкам в выходном Документе.
Свойство AllowGrouping (по умолчанию — true) - возвращает или задает, будут ли экспортироваться группирующие строки и иерархия групп. Если AllowGrouping равно false, экспортируются только строки данных.
DocumentCulture — Получает или устанавливает пользовательский объект CultureInfo, который определяет правила форматирования числовых значений и значений даты и времени в выходном Документе.

Если свойство DocumentCulture не указано, механизм экспорта использует текущие региональные параметры приложения.
Свойство ShowBands (по умолчанию — null) - возвращает или устанавливает, является ли контрол группы включены в экспорт.

Если ShowBands равно null, то свойство задается свойством DataGridControl.ShowBands контрола.
Свойство ShowColumnHeaders (по умолчанию - null) — Возвращает или устанавливает, включена ли панель заголовка столбца в экспорт.

Если ShowColumnHeaders равно null, то свойство настройки задается свойством DataGridControl.ShowColumnHeaders контрола.
ShowHorizontalLines — Возвращает или устанавливает, будут ли видны горизонтальные линии между ячейками в выходном Документе.
ShowVerticalLines — Возвращает или устанавливает, будут ли видны вертикальные линии между ячейками в выходном Документе.
Свойство TextExportMode — возвращает или устанавливает режим экспорта значений ячеек default.

Доступные опции включают:
- TextExportMode.Value — экспортирует значения ячеек. Если значения ячеек отформатированы в DataGrid контроле, механизм экспорта попытается применить соответствующее форматирование к экспортируемым значениям в выходном Документе.
- TextExportMode.Text — Экспортирует текст для отображения в ячейке. Если значения ячеек отформатированы в DataGrid контроле, экспортируется отформатированное строковое представление.
Вы можете использовать свойство GridColumn.TextExportMode, чтобы переопределить свойство XlsxExportOptions.TextExportMode для отдельных столбцов.
Записка

The export engine only takes into account cell formatting applied using the GridColumn.EditorProperties property. For example:
```
<mxdg:GridColumn Width="*" FieldName="Salary">
    <mxdg:GridColumn.EditorProperties>
        <mxe:TextEditorProperties DisplayFormatString="c"/>
    </mxdg:GridColumn.EditorProperties>
</mxdg:GridColumn>
```
Cell formatting applied using other approaches (for instance, with GridColumn.CellTemplate) is ignored during data export.

^* Эта страница была создана автоматически с помощью сервиса машинного перевода Яндекс Переводчик.