当前位置：首页 > news >正文

C#项目中添加本地数据库——SQLite

news 2026/5/12 19:34:31

C#项目中添加本地数据库

我们在日常开发工作中，不可避免地使用到数据库，这篇文章将介绍一个C# 轻量 ORM 库——SQLite.主要的概念介绍这里就不多说了，文章以干货为主。

1. 开发工具

Microsoft Visual Studio Community 2022 (64 位) - Current
版本 17.14.21 (November 2025)

2. 安装对应的 NuGet 包

1）在 Visual Studio 中：右键项目 → 管理 NuGet 包；
2）搜索并安装：sqlite-net-pcl.

3. 建立文件夹

建议是新建文件夹，将有关数据库的内容保存在一起，这样便于管理，以下是我的文件结构，可以用于参考。

其中：DatabaseManager.cs存放的是数据库的管理操作；UserRepository.cs存放的是对User数据表的管理操作；User.cs存放的是User数据表的结构。

4. 建立数据表

建立数据表的结构，也就是Model.以下是我的User.cs文件的内容，可以作为参考。

usingSQLite;namespaceMy.DatabaseModel{/// <summary>/// 用户表/// </summary>[Table("User")]publicclassUser{[PrimaryKey,AutoIncrement][Column("id")]publicintId{get;set;}[Column("userId")]publicstringDoctorId{get;set;}[Column("avatar")]publicstringAvatar{get;set;}[Column("name")]publicstringName{get;set;}}}

1）其中 [PrimaryKey, AutoIncrement]表示id是该表的主键，数值自增。
2）userId建议保持唯一性，可以根据id变化，以下是参考，根据id修改后一定要记得更新。

// 1️ 插入 UserDb.Insert(user);// 2️ 生成 PatientIduser.UserId="U"+(10000+user.Id);// 3️ 更新 UserDb.Update(user);

5. 建立数据库

数据库的操作基本上是初始化和销毁两个操作而已。

usingMy.DatabaseModel;usingSQLite;namespaceMy.Database{publicclassDatabaseManager{privatestaticSQLiteConnectiondb;privatestaticstringdbPath=Path.Combine(AppDomain.CurrentDomain.BaseDirectory,"myDatabase.db");publicstaticSQLiteConnectionDB{get{if(db==null){Init();}returndb;}}publicstaticvoidInit(){// 1 判断数据库是否存在booldbExists=File.Exists(dbPath);// 2 创建连接db=newSQLiteConnection(dbPath);if(!dbExists){Console.WriteLine("数据库不存在，创建数据库...");// 自动创建表// 用户表db.CreateTable<User>();}Console.WriteLine("数据库初始化完成");}/// <summary>/// 销毁数据库/// </summary>publicstaticvoidDestroyDatabase(){try{//1 关闭数据库连接if(db!=null){db.Close();db.Dispose();db=null;}//2 删除数据库文件if(File.Exists(dbPath)){File.Delete(dbPath);Console.WriteLine("数据库已销毁");}}catch(Exceptionex){Console.WriteLine("删除数据库失败: "+ex.Message);}}/// <summary>/// 重置数据库/// </summary>publicstaticvoidResetDatabase(){DestroyDatabase();Init();}}}

这里注意，销毁数据库时一定要先关闭数据库连接，再删除数据库文件。
private static string dbPath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "myDatabase.db");就是创建数据库文件，文件名为“myDatabase.db”.文件名可以自定义的，建议根据自己的需求更换具有标识性的文件名，建议以Database结尾。

6. 增加对数据表的操作

我将对数据表的操作以表为单位建立了文件——UserRepository.cs.以下是我的文件内容，可以作为参考。

usingMy.DatabaseModel;usingSQLite;namespaceRTLAB_MMDS.Database{publicclassUserRepository{privatestaticSQLiteConnectionDb=>DatabaseManager.DB;/// <summary>/// 插入数据/// </summary>/// <param name="user"></param>/// <returns></returns>publicUserInsertUser(Useruser){Db.Insert(user);returnuser;}/// <summary>/// 获取全部数据/// </summary>/// <returns></returns>publicList<User>GetAllUsers(){returnDb.Table<User>().ToList();}/// <summary>/// 根据用户id获取数据/// </summary>/// <param name="userId"></param>/// <returns></returns>publicUserGetUserByUserId(stringuserId){returnDb.Table<User>().FirstOrDefault(d=>d.UserId==userId);}/// <summary>/// 根据用户id删除患者/// <param name="userId"></param>/// </summary>publicvoidDelete(stringuserId){Db.Table<User>().Delete(d=>d.UserId==userId);}/// <summary>/// 更新用户/// </summary>publicUserUpdate(Useruser){Db.Update(user);returnuser;}}}

这种不涉及外键连接和多表组合的数据库操作是比较简单的，这里写的也不是很全，但是基本逻辑是这样的，相对复杂的等会放后面单独讲。
还有一个点要注意的是我基本上每一个都写了return，实际根据项目情况写就好，我这里是为了下面的操作示例写的而已。

7. 数据表的操作示例

下面就给一个简单的用户表增删改的操作示例。

privatevoidexample(){//初始化数据库DatabaseManager.Init();UserRepositoryrepo=newUserRepository();//创建用户Useruser1=newUser{UserId="123",Avatar="",Name="张三",};//插入user1=repo.InsertUser(user1);Console.WriteLine("创建用户成功："+user1.Name);// 查找Useruser2=repo.GetUserByUserId(user1.UserId);Console.WriteLine("查找用户成功："+user2.Name);// 修改user2.Name="李四";Useruser3=repo.Update(user2);Console.WriteLine("修改用户成功："+user3.Name);// 删除repo.Delete(user3);Console.WriteLine("删除用户成功");}

一定要初始化数据库，否则一切操作白搭，建议在Program.cs文件中就初始化。
好了，以上的基本内容就讲完了。每次总结的时候都觉得当初摸索的自己像个傻子，囧。

下面说一下组合表的事情吧。

数据库通常不会只有像上面User这样简单的表，一般可能还得存点别的结构，而在C#中又不给直接存什么List<string>；，还有数据比较大的情况下都存一张表检索又影响效率，所以，下面说一下组合的情况。

也是直接通过例子来讲解。

8. 组合表的结构

usingSQLite;namespaceMy.DatabaseModel{/// <summary>/// 患者表/// </summary>[Table("User")]publicclassUser{[PrimaryKey,AutoIncrement][Column("id")]publicintId{get;set;}[Column("userId")]publicstringDoctorId{get;set;}[Column("avatar")]publicstringAvatar{get;set;}[Column("name")]publicstringName{get;set;}[Ignore]// SQLite-Net 属性，告诉它不要映射到表publicList<Other>Others{get;set;}=newList<Other>();}/// <summary>/// 其他/// </summary>[Table("Other")]publicclassOther{[PrimaryKey,AutoIncrement][Column("id")]publicintId{get;set;}[Column("userId")]publicstringUserId{get;set;}[Column("otherName")]publicstringOtherName{get;set;}}}

1）Other也需要在初始化数据库时创建表，即在DatabaseManager.cs中添加db.CreateTable<Other>();
2）Other.UserId=User.userId，当然字段名是可以自定义的，不过建议相同，这样可读性比较高。
4）List<Other> Others；我这里存的是List，也可以存一条public Other OtherSingle{ get; set; } = new Other();如果存的OtherSingle，记得修改以下对组合表的操作。

9. 对组合表的操作

直接上代码吧，直观很重要！！！

usingMy.DatabaseModel;usingSQLite;namespaceRTLAB_MMDS.Database{publicclassUserRepository{privatestaticSQLiteConnectionDb=>DatabaseManager.DB;/// <summary>/// 插入数据/// </summary>/// <param name="user"></param>/// <returns></returns>publicUserInsertUser(Useruser){// RunInTransaction是保证数据库操作的原子性// 通俗解释就是RunInTransaction里面的代码只有两个结果，全部失败和全部成功Db.RunInTransaction(()=>{// 插入userDb.Insert(user);stringuserId=user.UserId;if(user.others!=null){foreach(varotherinuser.Others){other.UserId=userId;// 插入otherDb.Insert(other);}}});returnuser;}/// <summary>/// 获取全部数据/// </summary>/// <returns></returns>publicList<User>GetAllUsers(){varusers=Db.Table<User>().ToList();// 把 Other 表按 UserId 分组，生成一个可以快速查找的内存索引varotherLookup=Db.Table<Other>().ToList().ToLookup(p=>p.UserId);foreach(varuserinusers){// 这里就可以根据user.userId直接索引到全部数据啦user.Others=otherLookup[user.userId].ToList();}returnusers;}/// <summary>/// 根据用户id获取数据/// </summary>/// <param name="userId"></param>/// <returns></returns>publicUserGetUserByUserId(stringuserId){varuser=Db.Table<User>().FirstOrDefault(d=>d.UserId==userId);if(user==null)returnnull;user.Others=Db.Table<Other>().Where(p=>p.UserId==userId).ToList();returnuser;}/// <summary>/// 根据用户id删除患者/// <param name="userId"></param>/// </summary>publicvoidDelete(stringuserId){// 先删除子表里的数据Db.Table<Other>().Delete(a=>a.UserId==userId);// 再删除主表里的数据Db.Table<User>().Delete(d=>d.UserId==userId);}/// <summary>/// 更新用户/// </summary>publicUserUpdate(Useruser){Db.Update(user);stringuserId=user.UserId;// 删除旧OtherDb.Table<Other>().Delete(p=>p.userId==userId);// 插入新Otherif(user.Others!=null){foreach(varotherinuser.Others){other.UserId=userId;Db.Insert(other);}}returnuser;}}}

10. 插入组合表

这里就简单给一个插入的示例吧，其他操作都是相通的。

privatevoidexample(){//初始化数据库DatabaseManager.Init();UserRepositoryrepo=newUserRepository();//创建用户Useruser=newUser{UserId="123",Avatar="",Name="张三",};List<Other>others=newList<Other>();for(inti=0;i++;i<10){Otherother=newOther();other.OtherName=$"OtherName_{i}";others.Add(other);}user.Other=others;//插入user=repo.InsertUser(user);Console.WriteLine("创建用户成功："+user.Name);}