C# Avalonia怎么连接SQLite数据库 Avalonia数据库操作教程

在Avalonia中连接SQLite推荐使用Microsoft.Data.Sqlite配合Dapper，通过Environment.GetFolderPath获取可靠数据库路径，每次操作新建异步连接，UI更新需经Dispatcher调度确保线程安全。

在 Avalonia 中连接 SQLite 数据库，核心是使用 Microsoft.Data.Sqlite（推荐）或 System.Data.SQLite，配合异步操作适配 Avalonia 的 UI 线程模型。不需要额外的 ORM 也能快速上手，但搭配 Dapper 或 Entity Framework Core 会更高效。

安装必要 NuGet 包

在项目中添加以下包（以 .NET 6/7/8 + Avalonia 11 为例）：

• Microsoft.Data.Sqlite（轻量、官方维护、跨平台首选）
• （可选）Dapper（简化 CRUD，无配置、高性能）
• （可选）Microsoft.EntityFrameworkCore.Sqlite（如需 EF Core）

在终端运行：

创建数据库与表（代码优先）

避免手动管理 db 文件路径出错。推荐用 Environment.GetFolderPath 获取可靠路径，比如放在用户本地应用目录：

string dbPath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "myapp.db");
using var connection = new SqliteConnection($"Data Source={dbPath}");
connection.Open();
// 创建表（仅首次执行）
using var cmd = connection.CreateCommand();
cmd.CommandText = @"
CREATE TABLE IF NOT EXISTS Users (
Id INTEGER PRIMARY KEY AUTOINCREMENT,
Name TEXT NOT NULL,
Email TEXT UNIQUE
)";
cmd.ExecuteNonQuery();

封装安全的数据库访问服务

Avalonia 是单线程 UI 框架，所有数据库 I/O 必须异步执行，避免阻塞主线程。建议封装为独立服务，例如：

MedPeer科研绘图

生物医学领域的专业绘图解决方案，告别复杂绘图，专注科研创新

下载

• 定义接口 IDbService，含 Task> GetAllUsers() 等方法
• 实现类中统一管理连接字符串和连接生命周期（每次操作新建连接，不长期持有）
• 用 await connection.ExecuteAsync(...) 或 await connection.QueryAsync(...)（Dapper）

示例片段（Dapper）：

public async Task> GetAllUsers()
{
  string dbPath = GetDbPath();
  using var connection = new SqliteConnection($"Data Source={dbPath}");
  await connection.OpenAsync();
  return (await connection.QueryAsync("SELECT * FROM Users")).AsList();
}

在 ViewModel 中调用并更新 UI

在 ViewModel 中注入或实例化数据库服务，用 IAsyncRelayCommand 触发查询，并用 NotifyPropertyChanged 更新绑定属性：

• 声明 public ObservableCollection Users { get; } = new();
• 命令执行时：清空集合 → await 查询 → 逐个 Add（或用 ToObservableCollection()）
• 确保不在 UI 线程直接 await 后直接操作集合，Dapper 返回的 List 可安全遍历

注意：Avalonia 的 ObservableCollection 是线程敏感的，所有 Add/Remove 必须在 UI 线程。如果查询后需要更新，可用 Application.Current.Dispatcher.InvokeAsync(() => { ... }) 安全调度。

基本上就这些。SQLite + Microsoft.Data.Sqlite + Dapper 组合在 Avalonia 中稳定、轻量、易调试，适合中小项目快速落地。不用复杂配置，关键点就三个：路径可靠、连接不复用、UI 更新走 Dispatcher。