读取和写入 DBF 文件

Aspose.Cells 提供对读取和写入 DBF (dBASE) 文件的全面支持。您可以将现有的 dBASE III 和 dBASE IV 文件加载到 Workbook 对象中，使用功能丰富的 Aspose.Cells API 处理数据，然后将工作簿保存回 DBF 格式，以便与旧版数据库应用程序配合使用。

简介

DBF (DataBase File) 是一种旧版数据库文件格式，最初由 dBASE 在 1980 年代初期推出。尽管该格式年代久远，但 DBF 文件仍在许多行业中广泛用于存储结构化数据，特别是在会计、GIS 和其他专业应用程序中。Aspose.Cells 允许您将这些旧版文件无缝集成到现代 Node.js via C++ 电子表格工作流中。

该库支持读取和写入 DBF 文件，使您能够：

将现有 DBF 文件中的数据导入到 Aspose.Cells Workbook 对象中，以便进一步处理或转换为其他格式。
从头创建新的 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 类来指定源格式，确保在加载过程中正确解释数据。

使用 Aspose.Cells 读取 DBF 文件

要读取 DBF 文件，您需要创建一个 LoadOptions 实例，将其 LoadFormat 属性设置为 LoadFormat.Dbf，并将其与文件路径一起传递给 Workbook 构造函数。加载完成后，数据即可通过 Worksheets 集合进行访问，您可以在其中迭代单元格、提取值或根据需要处理数据。

以下示例演示了如何将现有 DBF 文件加载到 Aspose.Cells 中，访问其第一个工作表，并读取单元格的值。

let 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 += "|" + value;
    }
    sb += "|" + "\n";
}

console.log(sb);

const outputPath = path.join(dataDir, "output.xlsx");
workbook.save(outputPath, AsposeCells.SaveFormat.Xlsx);

console.log("DBF file loaded successfully. Converted XLSX saved at: " + outputPath);

您可以通过在"打开"对话框中选择文件来直接在 Microsoft Excel 中打开 DBF 文件。Excel 会将 DBF 文件视为电子表格，以表格布局显示其记录。这对于在使用 Aspose.Cells 读取或写入数据后快速验证数据非常有用。

写入 DBF 文件

将数据写入 DBF 文件的过程与使用 Aspose.Cells 保存其他电子表格格式类似。您可以创建或加载 Workbook，使用数据填充工作表，然后调用 save 方法，将 SaveFormat.Dbf 指定为目标格式。

使用 Aspose.Cells 写入 DBF 文件

要创建 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) 字段。
日期值 映射到 YYYYMMDD 格式的日期 (D) 字段。
布尔值 映射到逻辑 (L) 字段。

编码

DBF 文件可能使用不同的字符编码，具体取决于创建它们的应用程序。Aspose.Cells 在大多数情况下透明地处理编码，但如果您遇到字符显示问题，可能需要验证源文件的编码。

字段命名规则

DBF 字段名称必须遵守以下规则：

最大长度为 10 个字符。
必须以字母开头。
不能包含空格或特殊字符。
无论输入时使用什么大小写，都以大写形式存储。

验证输出

写入 DBF 文件后，您可以通过在 Microsoft Excel 或任何与 dBASE 兼容的应用程序中打开它来验证结果。数据应以表格布局显示，字段名称作为列标题，记录根据您提供的数据填充。

DBF 与其他格式之间的转换

使用 Aspose.Cells 读取和写入 DBF 文件最实用的用例之一是在 DBF 格式与现代电子表格格式（如 XLSX、XLS 或 CSV）之间转换数据。由于 Aspose.Cells 支持多种格式，您可以轻松加载 DBF 文件并将其重新保存为任何其他受支持的格式，反之亦然。

例如，您可以读取一个 DBF 文件，使用 Aspose.Cells API 应用格式或进行计算，然后将结果保存为 XLSX 文件，以便分发给使用现代电子表格应用程序的用户。反之，您可以从 XLSX 或 CSV 文件中获取数据并将其导出为 DBF 格式，以便与旧版系统集成。

将 Excel 转换为 OFD 格式 Pdf 通过 Node.js 结合 C++ 实现