SQLite数据操作流程
- 打开数据库连接
- 针对要操作的数据库,建立一个
SQLiteConnection
实例connection
。然后调用connection.Open()
- 这个连接实例在生存期内都是与数据库文件绑定的,也就是这个连接实例存在期间,你是不能对数据库文件做删除等操作的。
- 针对要操作的数据库,建立一个
- 创建事务
- 执行操作,这里的
操作
对应的是SQLite中的Command
。它是对SQL语句的封装。根据操作的不同,一般我们主要使用两种执行方式。- 需要返回数据。比如查。可以通过
command.ExecuteReader()
返回的SQLiteDataReader
对数据进行读取工作。 - 不需要返回数据。比如增删改。可以通过
command.ExecuteNonQuery()
,该函数返回数据库中受影响的列数。
- 需要返回数据。比如查。可以通过
- 提交事务,至此操作完成。
- 关闭数据库连接,调用
connection.Close()
。可选。- 如数据库操作很少,建议使用之后及时关闭。
- 如果会频繁使用,建议保留连接,避免每次需要都创建。
详细步骤
在项目中引入SQLite
右键项目选择 管理NuGet包:
接下来安装SQLite.Core
代码实例
- 创建数据库连接,我倾向于使用一个全局静态变量来一直保存数据库连接。
// 数据库文件夹 static string DbPath = Path.Combine(YatesHelper.GetAppDefaultPath(), "Database"); //与指定的数据库(实际上就是一个文件)建立连接 private static SQLiteConnection CreateDatabaseConnection(string dbName = null) { if (!string.IsNullOrEmpty(DbPath) && !Directory.Exists(DbPath)) Directory.CreateDirectory(DbPath); dbName = dbName == null ? "database.db" : dbName; var dbFilePath = Path.Combine(DbPath, dbName); return new SQLiteConnection("DataSource = " + dbFilePath); } // 使用全局静态变量保存连接 private static SQLiteConnection connection = CreateDatabaseConnection();
- 打开数据库连接
// 判断连接是否处于打开状态 private static void Open(SQLiteConnection connection) { if (connection.State != System.Data.ConnectionState.Open) { connection.Open(); } }
- 使用事务,使用using语句会使代码比较清晰。
using (var tr = connection.BeginTransaction())
- 执行非查询SQL语句代码,适用于建表、增删改等。
public static void ExecuteNonQuery(string sql) { // 确保连接打开 Open(connection); using (var tr = connection.BeginTransaction()) { using (var command = connection.CreateCommand()) { command.CommandText = sql; command.ExecuteNonQuery(); } tr.Commit(); } }
- 执行查询语句,因为查询涉及到具体的数据,这里只详细解释方法含义。
public static void ExecuteQuery(string sql) { // 确保连接打开 Open(connection); using (var tr = connection.BeginTransaction()) { using (var command = connection.CreateCommand()) { command.CommandText = sql; // 执行查询会返回一个SQLiteDataReader对象 var reader = command.ExecuteReader(); //reader.Read()方法会从读出一行匹配的数据到reader中。注意:是一行数据。 while (reader.Read()) { // 有一系列的Get方法,方法的参数是列数。意思是获取第n列的数据,转成Type返回。 // 比如这里的语句,意思就是:获取第0列的数据,转成int值返回。 var time = reader.GetInt64(0); } } tr.Commit(); } }
- 如何删除数据库?
// 因为SQLite是文件型数据库,可以直接删除文件。但只要数据库连接没有被回收,就无法删除文件。 public static void DeleteDatabase(string dbName) { var path = Path.Combine(DbPath, dbName); connection.Close(); // 置空,手动GC,并等待GC完成后执行文件删除。 connection = null; GC.Collect(); GC.WaitForPendingFinalizers(); File.Delete(path); }
问题
遇到的问题,主要是打包安装后会出现。问题的原因其实是一致的。如果你捕获了全局异常,就能从异常信息中得到错误原因。
SQLite.Interop.dll
的问题
System.BadImageFormatException: 试图加载格式不正确的程序。
System.DllNotFoundException: 无法加载 DLL“SQLite.Interop.dll”: 找不到指定的模块。
这个是因为从NuGet获得的包内是没有SQLite.Interop.dll
的,但是在Debug的时候,它会自动生成对应平台的dll。可以看一下项目目录下(../packages/System.Data.SQLite/build
)
里面有各个.NET
版本的对应平台的SQLite.Interop.dll
。打包的时候,将对应的文件一起打包即可。如果要兼顾x86
和x64
,也可以在打包时指定在应用文件夹,创建x86
和x64
目录,并将对应的SQLite.Interop.dll
放进去。这也是最保险的方法。
应用没有应用文件夹的访问权限
以管理员权限运行即可。