Nanorm.Sqlite 0.1.2

Nanorm

一个针对 ADO.NET 的小型数据访问辅助库。适合裁剪和 Native AOT 。

它支持

• PostgreSQL 通过 Npgsql
• SQLite 通过 Microsoft.Data.SQLite
• 任何 ADO.NET 数据提供程序通过 System.Data.Common

如何使用

Nanorm 支持 .NET 6+，并因 接口上的静态虚拟成员 和源生成器的支持而特别支持 .NET 7+。

入门

1. 安装适合您使用的 ADO.NET 提供程序（即数据库）的 Nanorm 包。在项目目录中使用 dotnet 命令行

   • PostgreSQL

     dotnet add package Nanorm.Npgsql --prerelease
     

   • SQLite

     dotnet add package Nanorm.Sqlite --prerelease
     

   • 所有其他 ADO.NET 提供程序

     dotnet add package Nanorm --prerelease
     

2. 创建一个 class、record 或 struct 来映射数据库查询结果。如果您正在使用 .NET 7 或 .NET 8，您可以将它设为 partial 并使用 [DataRecordMapper] 特性进行装饰以启用源生成器，该生成器将为您生成实现 IDataRecordMapper<T> 接口的代码

   [DataRecordMapper]
   public partial class Todo
   {
       public int Id { get; set; }
   
       public required string Title { get; set; }
   
       public bool IsComplete { get; set; }
   }
   
   // Generated for you if .NET 7+, otherwise you'll need to write it yourself
   partial class Todo : IDataRecordMapper<Todo>
   {
       public static Todo Map(System.Data.IDataRecord dataRecord) =>
           new()
           {
               Id = dataRecord.GetInt32("Id"),
               Title = dataRecord.GetString("Title"),
               IsComplete = dataRecord.GetBoolean("IsComplete"),
           };
   }
   

3. 创建适当的 IDbConnection 实例并使用 Nanorm 扩展方法之一执行查询。 QueryAsync 方法返回 IAsyncEnumerable，因此您可以使用 await foreach 遍历结果或简单地调用 ToListAsync() 以异步方式获取 List<T> 结果。

   // Using Npgsql to query a local PostgreSQL instance
   var connectionString = "Server=localhost;Port=5432;Username=postgres;Database=postgres";
   await using var db = new NpgsqlDataSourceBuilder(connectionString).Build();
   
   var todos = db.QueryAsync<Todo>("SELECT * FROM Todos");
   var todosList = await todos.ToListAsync();
   
   if (todosList.Count == 0)
   {
       Console.WriteLine("There are currently no todos!");
   }
   else
   {
       Console.WriteLine($"Found {todosList.Count} todo(s):");
       foreach (var todo in todosList)
       {
           Console.WriteLine($"({todo.Id}) {todo.Title}");
       }
   }
   

使用参数

Nanorm 支持几种将参数传递给查询的不同方法。

• 传递由 Nanorm 的 自定义字符串插值处理器 处理的插值字符串。这是首选方法。查询会自动以最佳方式参数化，即没有字符串连接，使用池分配等。

  var title = "Do the dishes";
  var result = db.QueryAsync<Todo>($"SELECT * FROM Todos WHERE Title = {title}")
  

• 传递 ADO.NET 提供程序的 DbParameter 实例作为参数，例如：

  var title = "Do the dishes";
  var sql = "SELECT * FROM Todos WHERE Title = $1";
  var result = db.QueryAsync<Todo>(sql, new NpgsqlParameter { Value =  title }))
  

• 传递一个回调，该回调修改 ADO.NET 提供程序的参数收集实现，例如：

  var title = "Do the dishes";
  var sql = "SELECT * FROM Todos WHERE Title = $1";
  var result = db.QueryAsync<Todo>(sql, parameters => parameters.Add(title))
  

扩展方法

以下扩展方法被提供，以便更容易地与数据库交互：

基准测试

Nanorm 设计为在 ADO.NET 之上一个非常薄的层，支持修剪和本地 AOT。以下是如何将其与原始 ADO.NET 和 Dapper 在简单插入 & 返回操作中相对于执行时间和内存分配进行比较。