MAUI SQLite数据库怎么用 MAUI本地数据库操作教程-C#.Net教程-PHP中文网

MAUI SQLite数据库怎么用 MAUI本地数据库操作教程

星降

发布： 2025-12-22 07:05:35

原创

528人浏览过

.NET MAUI中SQLite本地存储需装sqlite-net-pcl和SQLitePCLRaw.bundle_green两包，数据库路径用FileSystem.AppDataDirectory拼接，访问逻辑用SQLiteAsyncConnection异步初始化并操作。

maui sqlite数据库怎么用 maui本地数据库操作教程

在 .NET MAUI 中用 SQLite 做本地数据存储，核心就三件事：装对包、定好路径、写好访问逻辑。不复杂但容易忽略细节，比如少装一个依赖或路径写错，运行时直接报错。

必须安装的两个 NuGet 包

只装 sqlite-net-pcl 不够，它依赖底层 SQLite 实现，必须同步安装对应平台的绑定包：

sqlite-net-pcl（作者：praeclarum）—— 提供 SQLiteAsyncConnection 和模型映射能力
SQLitePCLRaw.bundle_green（不是 bundle_e_sqlite3 或其他变体）—— 为 Android/iOS/macOS/Windows 提供统一的原生 SQLite 支持

如果漏装 bundle_green，App 启动时大概率抛出 System.DllNotFoundException 或初始化失败。

数据库文件路径要写对

MAUI 没有“默认数据库目录”，必须手动拼出可写路径。推荐做法是建一个 Constants.cs：

public static class Constants
{
    public const string DatabaseFilename = "appdata.db3";
    public static string DatabasePath => Path.Combine(FileSystem.AppDataDirectory, DatabaseFilename);
}

登录后复制

注意：FileSystem.AppDataDirectory 在各平台自动指向安全私有目录（如 Android 的 /data/data/{package}/files/），千万别硬编码路径或用 Environment.GetFolderPath。

推荐用异步连接 + 延迟初始化

新建一个 DatabaseService.cs，封装连接和表初始化逻辑：

中英双语红色大气外贸企业网站源码1.1

注意：需要在本地调试我们的网站的必须安装配置IIS，不可以使用ASP调试工具.exe或小旋风asp或APMServ等这类工具调试，因为这类简易的IIS替代工具,去掉了很多功能,有些语句是不支持的。【程序】ASP 【数据库】ACCESS (只要支持ASP的空间均自带此数据库) 【前台】全部生成.html静态页面本程序专为企业网站进行打造，三大特色无与伦比： ☆全后台操作☆前台所有内容均可以后台

查看详情

用 SQLiteAsyncConnection 而非同步连接，避免阻塞 UI 线程
在构造函数里不做实际初始化，改用 async Task Init() 方法按需创建连接和表
首次调用前检查 Database == null，防止重复创建
调用 CreateTableAsync<t>()</t> 确保表存在（含主键、索引等基础结构）

示例关键代码：

private SQLiteAsyncConnection _database;
public async Task Init()
{
    if (_database != null) return;
    _database = new SQLiteAsyncConnection(Constants.DatabasePath);
    await _database.CreateTableAsync<User>();
}

登录后复制