读取和写入 DBF 文件

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

简介

DBF (DataBase File) 是一种旧版数据库文件格式，最初由 dBASE 于 20 世纪 80 年代初推出。尽管该格式年代久远，但 DBF 文件仍广泛用于许多行业，用于存储结构化数据，尤其是在会计、GIS 和其他专业应用程序中。Aspose.Cells 使您能够将这些旧版文件无缝集成到现代 Java 电子表格工作流程中。 该库支持读取和写入 DBF 文件，使您能够：

• 将数据从现有 DBF 文件导入到 Aspose.Cells Workbook 对象中，以便进一步处理或转换为其他格式。
• 从头创建新的 DBF 文件，或通过转换其他电子表格格式的数据来生成 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 构造函数。加载完成后，可以通过 getWorksheets() 集合访问数据，您可以在其中遍历单元格、提取值或根据需要操作数据。 以下示例演示了如何将现有 DBF 文件加载到 Aspose.Cells 中，访问其第一个工作表，并读取单元格的值。

import com.aspose.cells.*;
import java.io.File;
String dataDir = "Data/";
String filePath = new File(new File(dataDir), "example.dbf").getPath();
LoadOptions loadOptions = new LoadOptions(LoadFormat.DBF);
Workbook workbook = new Workbook(filePath, loadOptions);
Worksheet worksheet = workbook.getWorksheets().get(0);
Cells cells = worksheet.getCells();
StringBuilder sb = new StringBuilder();
int maxRow = cells.getMaxDataRow();
int maxCol = cells.getMaxDataColumn();
for (int i = 0; i <= maxRow; i++)
{
    for (int j = 0; j <= maxCol; j++)
    {
        Cell cell = cells.get(i, j);
        String value = cell.getStringValue();
        sb.append("|").append(value);
    }
    sb.append("|").append(System.lineSeparator());
}
System.out.println(sb.toString());
String outputPath = new File(new File(dataDir), "output.xlsx").getPath();
workbook.save(outputPath, SaveFormat.XLSX);
System.out.println("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 文件，请按照以下步骤操作：

1. 创建一个新的 Workbook 实例。
2. 从 getWorksheets() 集合访问第一个工作表。
3. 使用您的数据填充工作表，第一行包括表头，后续行包括记录。
4. 调用 Workbook.save 方法，将文件路径和 SaveFormat.Dbf 作为参数传递。 以下示例演示了如何从头创建新的 DBF 文件。它使用包含不同数据类型（字符串、数字和日期）的示例数据填充工作表，以说明在导出到 DBF 格式时如何处理字段类型。

import com.aspose.cells.*;
import java.io.File;
import java.util.GregorianCalendar;
String outputDir = "C:\\Output\\";
String filePath = new File(new File(outputDir), "output.dbf").getPath();
if (!new File(outputDir).exists())
{
    new File(outputDir).mkdirs();
}
Workbook workbook = new Workbook();
Worksheet worksheet = workbook.getWorksheets().get(0);
Cells 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 GregorianCalendar(2020, 2, 15).getTime());
// 数据行 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 GregorianCalendar(2019, 6, 22).getTime());
// 数据行 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 GregorianCalendar(2021, 0, 10).getTime());
// 数据行 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 GregorianCalendar(2018, 10, 5).getTime());
// 数据行 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 GregorianCalendar(2022, 4, 30).getTime());
// 设置列宽以提高可读性
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, 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 格式，以便与旧版系统集成。