返回资讯中心
外部精选
软件工程
#开发者实时流

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。

Hacker News 最新nwah12026/11/6 · 11 天前21 分钟阅读

以下正文由 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 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →