Analyzing your prompt, please hold on...
An error occurred while retrieving the results. Please refresh the page and try again.
Чтение и запись файлов DBF
Contents
[
Hide
]
Aspose.Cells обеспечивает полную поддержку чтения и записи файлов DBF (dBASE). Вы можете загружать существующие файлы dBASE III и dBASE IV в объект Workbook, обрабатывать данные с помощью многофункционального API Aspose.Cells и сохранять рабочую книгу обратно в формат DBF для использования с устаревшими приложениями баз данных.
Введение
DBF (DataBase File) — это устаревший формат файлов баз данных, первоначально представленный dBASE в начале 1980-х годов. Несмотря на возраст формата, файлы DBF по-прежнему широко используются во многих отраслях для хранения структурированных данных, особенно в бухгалтерском учёте, ГИС и других специализированных приложениях. Aspose.Cells позволяет легко интегрировать эти устаревшие файлы в современные рабочие процессы с электронными таблицами на Node.js via C++. Библиотека поддерживает как чтение, так и запись файлов DBF, предоставляя вам возможность:
- Импортировать данные из существующих файлов DBF в объекты Workbook Aspose.Cells для дальнейшей обработки или преобразования в другие форматы.
- Создавать новые файлы DBF с нуля или путём преобразования данных из других форматов электронных таблиц.
- Сохранять определения полей, типы данных и структуры записей при передаче данных в формат DBF и обратно. Файлы DBF также можно открывать непосредственно в Microsoft Excel и других приложениях для работы с электронными таблицами, что делает их удобным мостом между устаревшими системами и современными инструментами для работы с электронными таблицами.
Поддерживаемые версии DBF и функции
Aspose.Cells поддерживает следующие версии формата DBF:
- dBASE III — оригинальный и наиболее широко поддерживаемый вариант формата DBF.
- dBASE IV — расширенная версия, которая поддерживает дополнительные типы данных и поля большего размера.
Поддерживаемые функции
Библиотека обеспечивает комплексную поддержку следующих операций:
- Чтение данных DBF в объект Workbook с сохранением всех записей и определений полей.
- Запись данных рабочей книги обратно в формат DBF для экспорта в приложения, совместимые с dBASE.
- Обработка распространённых типов данных, используемых в файлах DBF, включая символьные, числовые, поля дат и логические поля.
- Сохранение определений полей, таких как имя поля, тип и длина, во время операций чтения/записи.
Ограничения и особенности
При работе с файлами DBF учитывайте следующие ограничения:
- Максимальное количество полей в файле — 128.
- Максимальный размер записи — 4000 байт.
- Имена полей ограничены 10 символами, должны быть в верхнем регистре и не могут содержать пробелов.
- Значения дат в файлах DBF хранятся в формате
YYYYMMDD. - Кодировка символов может различаться в зависимости от исходного приложения (обычно Windows-1252 или OEM-кодировки).
Чтение файла DBF
Aspose.Cells упрощает загрузку данных из файла DBF в объект Workbook. Библиотека использует класс LoadOptions для указания исходного формата, обеспечивая правильную интерпретацию данных в процессе загрузки.
Чтение файла DBF с помощью Aspose.Cells
Чтобы прочитать файл DBF, необходимо создать экземпляр LoadOptions, установить его свойство LoadFormat в значение LoadFormat.Dbf и передать его в конструктор Workbook вместе с путём к файлу. После загрузки данные становятся доступными через коллекцию Worksheets, где вы можете перебирать ячейки, извлекать значения или обрабатывать данные по мере необходимости.
Следующий пример демонстрирует, как загрузить существующий файл DBF в Aspose.Cells, получить доступ к первому рабочему листу и прочитать значения ячеек.
const AsposeCells = require("aspose.cells");
const path = require("path");
const dataDir = "Data/";
const filePath = path.join(dataDir, "example.dbf");
const loadOptions = new AsposeCells.LoadOptions(AsposeCells.LoadFormat.Dbf);
const workbook = new AsposeCells.Workbook(filePath, loadOptions);
const worksheet = workbook.getWorksheets().get(0);
const cells = worksheet.getCells();
const sb = [];
const maxRow = cells.getMaxDataRow();
const maxCol = cells.getMaxDataColumn();
for (let i = 0; i <= maxRow; i++)
{
for (let j = 0; j <= maxCol; j++)
{
const cell = cells.get(i, j);
const value = cell.getStringValue();
sb.push("|");
sb.push(value);
}
sb.push("|");
sb.push("\n");
}
console.log(sb.join(""));
const outputPath = path.join(dataDir, "output.xlsx");
workbook.save(outputPath, AsposeCells.SaveFormat.Xlsx);
console.log("DBF file loaded successfully. Converted XLSX saved at: " + outputPath);
Вы можете открывать файлы DBF непосредственно в Microsoft Excel, выбрав файл в диалоговом окне открытия. Excel будет рассматривать файл DBF как электронную таблицу, отображая его записи в табличном виде. Это полезно для быстрой проверки данных после чтения или записи с помощью Aspose.Cells.
Запись файла DBF
Запись данных в файл DBF следует тому же шаблону, что и сохранение любого другого формата электронных таблиц с помощью Aspose.Cells. Вы создаёте или загружаете Workbook, заполняете рабочий лист данными, а затем вызываете метод save, указывая SaveFormat.Dbf в качестве целевого формата.
Запись файла DBF с помощью Aspose.Cells
Чтобы создать файл DBF, выполните следующие шаги:
- Создайте новый экземпляр
Workbook. - Получите доступ к первому рабочему листу из коллекции
Worksheets. - Заполните рабочий лист данными, включая заголовки в первой строке и записи в последующих строках.
- Вызовите метод
workbook.save, передав путь к файлу иSaveFormat.Dbfв качестве параметров. Следующий пример демонстрирует, как создать новый файл DBF с нуля. Он заполняет рабочий лист образцами данных, содержащими различные типы данных (строки, числа и даты), чтобы проиллюстрировать обработку типов полей при экспорте в формат DBF.
const AsposeCells = require("aspose.cells");
const path = require("path");
const fs = require("fs");
const outputDir = "C:\\Output\\";
const filePath = path.join(outputDir, "output.dbf");
if (!fs.existsSync(outputDir)) {
fs.mkdirSync(outputDir, { recursive: true });
}
const workbook = new AsposeCells.Workbook();
const worksheet = workbook.getWorksheets().get(0);
const cells = worksheet.getCells();
// Заголовки столбцов
cells.get(0, 0).putValue("ID");
cells.get(0, 1).putValue("Name");
cells.get(0, 2).putValue("Department");
cells.get(0, 3).putValue("Salary");
cells.get(0, 4).putValue("HireDate");
// Строка данных 1
cells.get(1, 0).putValue(101);
cells.get(1, 1).putValue("John Smith");
cells.get(1, 2).putValue("Engineering");
cells.get(1, 3).putValue(75000.50);
cells.get(1, 4).putValue(new Date(2020, 2, 15));
// Строка данных 2
cells.get(2, 0).putValue(102);
cells.get(2, 1).putValue("Jane Doe");
cells.get(2, 2).putValue("Marketing");
cells.get(2, 3).putValue(68000.75);
cells.get(2, 4).putValue(new Date(2019, 6, 22));
// Строка данных 3
cells.get(3, 0).putValue(103);
cells.get(3, 1).putValue("Bob Johnson");
cells.get(3, 2).putValue("Finance");
cells.get(3, 3).putValue(82000.00);
cells.get(3, 4).putValue(new Date(2021, 0, 10));
// Строка данных 4
cells.get(4, 0).putValue(104);
cells.get(4, 1).putValue("Alice Brown");
cells.get(4, 2).putValue("Human Resources");
cells.get(4, 3).putValue(71000.25);
cells.get(4, 4).putValue(new Date(2018, 10, 5));
// Строка данных 5
cells.get(5, 0).putValue(105);
cells.get(5, 1).putValue("Charlie Wilson");
cells.get(5, 2).putValue("Operations");
cells.get(5, 3).putValue(79500.80);
cells.get(5, 4).putValue(new Date(2022, 4, 30));
// Установка ширины столбцов для лучшей читаемости
worksheet.getCells().setColumnWidth(0, 8);
worksheet.getCells().setColumnWidth(1, 20);
worksheet.getCells().setColumnWidth(2, 20);
worksheet.getCells().setColumnWidth(3, 12);
worksheet.getCells().setColumnWidth(4, 14);
workbook.save(filePath, AsposeCells.SaveFormat.Dbf);
При записи данных в файл DBF убедитесь, что ваши данные соответствуют ограничениям формата. Имена полей не должны превышать 10 символов и не должны содержать пробелов. Записи, превышающие 4000 байт в общей сложности, не будут сохранены корректно. Даты должны быть допустимыми значениями дат, которые могут быть представлены в формате YYYYMMDD.
Особенности типов данных и форматирования
При передаче данных между Aspose.Cells и форматом DBF важно понимать, как типы данных сопоставляются между двумя системами, чтобы обеспечить целостность данных.
Типы ячеек и типы полей DBF
Значения ячеек Aspose.Cells автоматически преобразуются в соответствующие типы полей DBF при сохранении:
- Строки сопоставляются с символьными (C) полями.
- Числовые значения (целые числа и десятичные дроби) сопоставляются с числовыми (N) полями.
- Значения дат сопоставляются с полями даты (D) в формате
YYYYMMDD. - Логические значения сопоставляются с логическими (L) полями.
Кодировка
Файлы DBF могут использовать различные кодировки символов в зависимости от приложения, которое их создало. Aspose.Cells обрабатывает кодировку прозрачно в большинстве случаев, но если у вас возникают проблемы с отображением символов, возможно, потребуется проверить кодировку исходного файла.
Правила именования полей
Имена полей DBF должны соответствовать следующим правилам:
- Максимальная длина — 10 символов.
- Должны начинаться с буквы.
- Не должны содержать пробелов или специальных символов.
- Сохраняются в верхнем регистре независимо от регистра, использованного при вводе.
Проверка результата
После записи файла DBF вы можете проверить результат, открыв его в Microsoft Excel или любом другом приложении, совместимом с dBASE. Данные должны отображаться в табличном виде с именами полей в качестве заголовков столбцов и записями, заполненными в соответствии с предоставленными вами данными.
Преобразование между DBF и другими форматами
Одним из наиболее практичных вариантов использования чтения и записи файлов DBF с помощью Aspose.Cells является преобразование данных между форматом DBF и современными форматами электронных таблиц, такими как XLSX, XLS или CSV. Поскольку Aspose.Cells поддерживает широкий спектр форматов, вы можете легко загрузить файл DBF и сохранить его в любом другом поддерживаемом формате или наоборот. Например, вы можете прочитать файл DBF, применить форматирование или вычисления с помощью API Aspose.Cells, а затем сохранить результат в виде файла XLSX для распространения среди пользователей, работающих с современными приложениями для работы с электронными таблицами. И наоборот, вы можете взять данные из файла XLSX или CSV и экспортировать их в формат DBF для интеграции с устаревшими системами.