JetDatabaseWriter 发布:纯 C# 直接读写 Access 数据库
来源标题:Fast, Portable, Pure .NET Access Jet/Ace Database Engine
JetDatabaseWriter 是一个 100% 托管 C# 库,无需 OleDB、ODBC、COM 或原生驱动即可直接读写 Jet3、Jet4 和 ACE 格式的 Access 数据库。它支持文件与流的页面级存储、B+Tree 索引、RC4 与 AES 加密,并提供异步优先的 .NET API。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
JetDatabaseWriter 是一个 100% 托管 C# 库,可直接从文件或流中创建、查询和更新 Microsoft Access(Jet3、Jet4 和 ACE)数据库——完全不依赖 OleDB、ODBC、COM 或原生驱动。
ACE .ACCDB · 4096B JET4 .MDB · UTF-16 JET3 .MDB · 2048B 0x01 · 数据页与 TDEF 页 槽式行 · OMAP 位图 LVAL 内联与多页链 0x04 · B+树索引节点 Gen97 · GenLegacy · General 前缀压缩的分支与叶子 加密 · RC4 与 AGILE AES AES-128/192/256 · CBC 与 CFB8 CryptoAPI 与标准 AES Dafny 验证内核 + 异步优先 .NET API Stream <-> CLOCK 缓存 <-> .jdw-journal 撤销 <-> IQueryable<T> 零原生 DLL · 检查算术 · 原生 DAO 3.6 与 12.0 验证 直接页级存储引擎 下载 Logo SVG
功能
读取、查询和编写 Access 数据库所需的一切
从零开始用纯 C# 构建,直接操作 JET 和 ACE 页帧、目录、B+树索引以及复杂列。
纯托管 .NET 面向 net11.0 和 netstandard2.1(.NET Core 3.x 和 .NET 5–11)。可在 Windows、Linux 和 macOS 上运行,零 P/Invoke、COM、OleDB 或 ACE 可再发行驱动。
Jet3、Jet4 与 ACE 格式 从磁盘路径或任何可寻址 Stream 读取、写入和创建 Access 97(Jet3Mdb)、Access 2000–2003(Jet4Mdb)和 Access 2007+(AceAccdb)文件。
POCO 映射与异步 LINQ 通过 Rows<T> 流式读取行,通过 FromIndex<T> 查找 B+树索引,或用 Query<T>(IQueryable<T>)组合查询,支持自动索引选择和 Include / ThenInclude。
完整架构与行写入器 创建、重命名和删除表、列和索引;强制执行主键和外键,支持级联更新和删除;评估默认值、验证规则和计算字段。
内置加密与维护 读取和更新 Jet3/Jet4 RC4、ACE CryptoAPI、标准 AES 和 Agile AES-128/192/256 数据库。通过原子文件替换进行加密、解密和轮换密码。
事务与崩溃恢复 通过 CommitAsync 和 RollbackAsync 对变更进行分组或嵌套。相邻的 .jdw-journal 回滚日志和 Dafny 验证内核可在重新打开时恢复被中断的文件事务。
在读取、LINQ 查询、架构编写、事务、加密和 CLI 模型脚手架之间切换。
using JetDatabaseWriter;
await using var reader = await AccessReader.OpenAsync("Northwind.mdb");
// 列出目录中的用户表
var tables = await reader.ListTablesAsync();
// 以自动索引推断的方式惰性流式读取强类型 POCO
await foreach (var order in reader.Rows<Order>("Orders", o => o.CustomerId == 42))
Console.WriteLine($"Order #{order.OrderID}: {order.Freight:C}");
public sealed class Order
{
public int OrderID { get; set; }
public int CustomerId { get; set; }
public decimal Freight { get; set; }
}
流式读取与 POCO 投影 属性以不区分大小写的方式匹配列名,或通过 [Column("...")] 特性匹配。
using JetDatabaseWriter;
using JetDatabaseWriter.Linq;
await using var reader = await AccessReader.OpenAsync("Northwind.accdb");
var recentOrders = await reader.Query<Order>("Orders")
.Include(o => o.Customer)
.ThenInclude(c => c!.Region)
.Where(o => o.Freight >= 50m)
.OrderByDescending(o => o.OrderID)
.Take(25)
.ToListAsync();
异步 IQueryable<T> 提供程序 使用熟悉的 LINQ 运算符组合查询,并通过关系推断进行预加载。
using JetDatabaseWriter;
using JetDatabaseWriter.Enums;
using JetDatabaseWriter.Models;
await using var writer = await AccessWriter.CreateDatabaseAsync(
"contacts.accdb", DatabaseFormat.AceAccdb);
await writer.CreateTableAsync("Contacts", new[]
{
new ColumnDefinition("Id", typeof(int)) { IsPrimaryKey = true, IsAutoNumber = true },
new ColumnDefinition("Email", typeof(string), maxLength: 120) { IsRequired = true },
new ColumnDefinition("CreatedUtc", typeof(DateTime)) { DefaultValue = "=Now()" },
}, new[]
{
new IndexDefinition("IX_Contacts_Email", "Email") { IsUnique = true },
});
await writer.InsertRowAsync("Contacts", new RowValues
{
["Email"] = "alice@example.com",
});
编写与架构演进 从零创建数据库,或用 AccessWriter.OpenAsync 打开现有文件。
using JetDatabaseWriter;
using JetDatabaseWriter.Models;
await using var writer = await AccessWriter.OpenAsync("ledger.accdb");
await using var tx = await writer.BeginTransactionAsync();
await writer.UpdateRowsAsync(
"Accounts",
RowCriteria.Where("AccountId", 101),
new RowValues { ["Balance"] = 950.00m });
await writer.InsertRowAsync("AuditLog", new RowValues
{
["AccountId"] = 101,
["Delta"] = -50.00m,
});
await tx.CommitAsync();
原子语句与崩溃恢复 将多个行和架构变更分组为带嵌套保存点的原子事务。
using JetDatabaseWriter;
// 打开加密数据库
await using var reader = await AccessReader.OpenAsync(
"protected.accdb",
new AccessReaderOptions("correct-horse-battery-staple"));
// 通过原子暂存就地加密、解密或轮换密码
await AccessDatabaseEncryption.ChangePasswordAsync(
"protected.accdb",
oldPassword: "correct-horse-battery-staple",
newPassword: "new-strong-passphrase");
多代加密 使用托管 .NET 加密读取、更新和维护加密的 Access 数据库。
# 从现有文件生成 C# 实体类和关系导航属性
dotnet run --project src/JetDatabaseWriter.Scaffold -- \
--database Northwind.accdb \
--output ./Models \
--namespace MyApp.Data \
--records \
--nullable
实体模型脚手架 CLI 检查任何 .mdb 或 .accdb 目录,并生成可直接编译的 C# 模型。
互操作性持续针对 Microsoft 编写的测试夹具、DAO 3.6 和固定版本的 ACEDAO 12.0 进行验证。
存储引擎要求严格的不变量。JetDatabaseWriter 结合了数学证明模型、原生 Microsoft Access 运行时验证和对抗性模糊测试。
Dafny 验证的恢复与编解码内核
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。