C# SQLite
最后修改于 2023 年 7 月 5 日
C# SQLite 教程展示了如何在 C# 中对 SQLite 数据库进行编程。
SQLite
SQLite 是一个嵌入式关系型数据库引擎。它是一个自包含、无服务器、零配置的事务性 SQL 数据库引擎。SQLite 实现了 SQL-92 标准中的大部分内容。SQLite 引擎不是一个独立的进程，而是静态或动态地链接到应用程序中。一个 SQLite 数据库是一个普通的磁盘文件，可以位于目录层次结构中的任何位置。
ADO.NET
ADO.NET 是 .NET 的一个重要组成部分。它是一个统一访问关系型数据库、XML 文件和其他应用程序数据的规范。从程序员的角度来看，它是一组用于处理数据库和其他数据源的库和类。System.Data.SQLite.Core 是 ADO.NET 规范针对 SQLite 数据库的一个实现。它是一个用 C# 语言编写的驱动程序，可用于所有 .NET 语言。
$ dotnet add package System.Data.SQLite.Core
我们需要将这个包添加到我们的 .NET Core 项目中。
SQLiteConnection、SQLiteCommand、SQLiteDataReader、SQLiteDataAdapter 是 .NET 数据提供程序模型的核心元素。SQLiteConnection 创建到特定数据源的连接。SQLiteCommand 对象对数据源执行 SQL 语句。SQLiteDataReader 从数据源读取数据流。SQLiteDataAdapter 是 DataSet 和数据源之间的中介。它填充一个 DataSet 并将更新解析到数据源。
DataSet 对象用于对大量数据进行离线操作。它是一种可以容纳来自各种不同来源的数据的非连接数据表示。SQLiteDataReader 和 DataSet 都用于处理数据；它们在不同的情况下使用。如果我们只需要读取查询结果，SQLiteDataReader 是更好的选择。如果我们需要对数据进行更广泛的处理，或者想将 Winforms 控件绑定到数据库表，那么首选 DataSet。
SQLite C# 版本
在第一个程序中，我们检查 SQLite 数据库的版本。
using System.Data.SQLite;
string cs = "Data Source=:memory:";
string stm = "SELECT SQLITE_VERSION()";
using var con = new SQLiteConnection(cs);
con.Open();
using var cmd = new SQLiteCommand(stm, con);
string version = cmd.ExecuteScalar().ToString();
Console.WriteLine($"SQLite version: {version}");
我们连接到一个内存数据库并查询 SQLite 版本。
using System.Data.SQLite;
我们导入 SQLite 数据提供程序的元素。
string cs = "Data Source=:memory:";
这是连接字符串。数据提供程序使用它来建立与数据库的连接。我们创建一个内存数据库。
string stm = "SELECT SQLITE_VERSION()";
我们创建一个 SELECT 语句。SQLITE_VERSION 是一个内置的 SQLite 函数，它返回 SQLite 的版本。
using var con = new SQLiteConnection(cs);
创建了一个 SQLiteConnection 对象。此对象用于打开与数据库的连接。using 声明会在封闭作用域的末尾释放 con 变量。
con.Open();
Open 方法打开数据库连接。
using var cmd = new SQLiteCommand(stm, con);
SQLiteCommand 是一个用于在数据库上执行查询的对象。其参数是 SQL 语句和连接对象。
string version = cmd.ExecuteScalar().ToString();
有些查询只返回一个标量值。在我们的例子中，我们想要一个指定数据库版本的简单字符串。在这种情况下使用 ExecuteScalar。我们避免了使用更复杂对象所带来的开销。
Console.WriteLine($"SQLite version: {version}");
数据库的版本被打印到控制台。
$ dotnet run SQLite version: 3.30.1
C# SQLite 创建表
在下面的示例中，我们创建一个数据库表并用数据填充它。
using System.Data.SQLite;
string cs = @"URI=file:C:\Users\Jano\Documents\test.db";
using var con = new SQLiteConnection(cs);
con.Open();
using var cmd = new SQLiteCommand(con);
cmd.CommandText = "DROP TABLE IF EXISTS cars";
cmd.ExecuteNonQuery();
cmd.CommandText = @"CREATE TABLE cars(id INTEGER PRIMARY KEY,
name TEXT, price INT)";
cmd.ExecuteNonQuery();
cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Audi',52642)";
cmd.ExecuteNonQuery();
cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Mercedes',57127)";
cmd.ExecuteNonQuery();
cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Skoda',9000)";
cmd.ExecuteNonQuery();
cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Volvo',29000)";
cmd.ExecuteNonQuery();
cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Bentley',350000)";
cmd.ExecuteNonQuery();
cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Citroen',21000)";
cmd.ExecuteNonQuery();
cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Hummer',41400)";
cmd.ExecuteNonQuery();
cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Volkswagen',21600)";
cmd.ExecuteNonQuery();
Console.WriteLine("Table cars created");
在这个例子中，我们创建了一个包含八行数据的 cars 表。
cmd.CommandText = "DROP TABLE IF EXISTS cars"; cmd.ExecuteNonQuery();
首先，如果表已存在，我们先删除它。当我们不想要结果集时，例如对于 DROP、INSERT 或 DELETE 语句，我们使用 ExecuteNonQuery 方法。
cmd.CommandText = @"CREATE TABLE cars(id INTEGER PRIMARY KEY,
name TEXT, price INT)";
cmd.ExecuteNonQuery();
cars 表被创建。在 SQLite 中，INTEGER PRIMARY KEY 列是自增的。
cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Audi',52642)";
cmd.ExecuteNonQuery();
cmd.CommandText = "INSERT INTO cars(name, price) VALUES('Mercedes',57127)";
cmd.ExecuteNonQuery();
我们向表中插入两行数据。
$ dotnet run Table cars created
我们运行该程序。
$ sqlite3 test.db
我们使用 sqlite3 工具打开 test.db 数据库。
sqlite> .mode column sqlite> .headers on
我们修改了数据在控制台中的默认显示方式。我们使用列模式并打开了表头。
sqlite> SELECT * FROM cars; id name price ---------- ---------- ---------- 1 Audi 52642 2 Mercedes 57127 3 Skoda 9000 4 Volvo 29000 5 Bentley 350000 6 Citroen 21000 7 Hummer 41400 8 Volkswagen 21600
我们验证数据。cars 表已成功创建。
C# SQLite 预处理语句
预处理语句可以提高安全性和性能。当我们编写预处理语句时，我们使用占位符而不是直接将值写入语句中。
using System.Data.SQLite;
string cs = @"URI=file:C:\Users\Jano\Documents\test.db";
using var con = new SQLiteConnection(cs);
con.Open();
using var cmd = new SQLiteCommand(con);
cmd.CommandText = "INSERT INTO cars(name, price) VALUES(@name, @price)";
cmd.Parameters.AddWithValue("@name", "BMW");
cmd.Parameters.AddWithValue("@price", 36600);
cmd.Prepare();
cmd.ExecuteNonQuery();
Console.WriteLine("row inserted");
我们向 cars 表添加一行。我们使用一个参数化命令。
cmd.CommandText = "INSERT INTO cars(name, price) VALUES(@name, @price)";
当我们编写预处理语句时，我们使用占位符而不是直接将值写入语句中。预处理语句速度更快，并能防范 SQL 注入攻击。@name 和 @price 是占位符，稍后将被填充。
cmd.Parameters.AddWithValue("@name", "BMW");
cmd.Parameters.AddWithValue("@price", 36600);
cmd.Prepare();
值被绑定到占位符上。
cmd.ExecuteNonQuery();
预处理语句被执行。当不期望返回任何数据时，我们使用 SQLiteCommand 对象的 ExecuteNonQuery 方法。
sqlite> SELECT * FROM cars WHERE id=8; id name price ---------- ---------- ---------- 8 Volkswagen 21600
我们验证该行是否已成功插入。
C# SQLiteDataReader
SQLiteDataReader 是一个用于从数据库检索数据的类。它与 SQLiteCommand 类一起使用，以执行 SELECT 语句，然后访问返回的行。它提供对查询结果的快速、只进、只读的访问。这是从表中检索数据的最有效方法。
我们通过调用 SQLiteCommand 对象的 ExecuteReader 方法来创建 SQLiteDataReader 的实例。在使用 SqlDataReader 期间，关联的 SQLiteConnection 专门为 SqlDataReader 服务。除了关闭 SQLiteConnection 之外，不能在其上执行任何其他操作。
using System.Data.SQLite;
string cs = @"URI=file:C:\Users\Jano\Documents\test.db";
using var con = new SQLiteConnection(cs);
con.Open();
string stm = "SELECT * FROM cars LIMIT 5";
using var cmd = new SQLiteCommand(stm, con);
using SQLiteDataReader rdr = cmd.ExecuteReader();
while (rdr.Read())
{
Console.WriteLine($"{rdr.GetInt32(0)} {rdr.GetString(1)} {rdr.GetInt32(2)}");
}
我们从 cars 表中获取五行数据并将它们打印到控制台。
using SQLiteDataReader rdr = cmd.ExecuteReader();
要创建一个 SQLiteDataReader 对象，我们调用 SQLiteCommand 对象的 ExecuteReader 方法。
while (rdr.Read())
{
Console.WriteLine($"{rdr.GetInt32(0)} {rdr.GetString(1)} {rdr.GetInt32(2)}");
}
Read 方法将数据读取器推进到下一条记录。如果还有更多行，则返回 true；否则返回 false。我们可以使用数组索引表示法来检索值，或者使用特定的方法以其原生数据类型访问列值。后者效率更高。
$ dotnet run 1 Audi 52642 2 Mercedes 57127 3 Skoda 9000 4 Volvo 29000 5 Bentley 350000
C# SQLite 列标题
在下面的示例中，我们将列标题与数据库表中的数据一起打印出来。
using System.Data.SQLite;
string cs = @"URI=file:C:\Users\Jano\Documents\test.db";
using var con = new SQLiteConnection(cs);
con.Open();
string stm = "SELECT * FROM cars LIMIT 5";
using var cmd = new SQLiteCommand(stm, con);
using SQLiteDataReader rdr = cmd.ExecuteReader();
Console.WriteLine($"{rdr.GetName(0), -3} {rdr.GetName(1), -8} {rdr.GetName(2), 8}");
while (rdr.Read())
{
Console.WriteLine($@"{rdr.GetInt32(0), -3} {rdr.GetString(1), -8} {rdr.GetInt32(2), 8}");
}
在这个例子中，我们从 cars 表中选择五行数据及其列名。
using SQLiteDataReader rdr = cmd.ExecuteReader();
创建了一个 SQLiteDataReader 对象。
Console.WriteLine($"{rdr.GetName(0), -3} {rdr.GetName(1), -8} {rdr.GetName(2), 8}");
我们使用读取器的 GetName 方法获取列名。
while (rdr.Read())
{
Console.WriteLine($@"{rdr.GetInt32(0), -3} {rdr.GetString(1), -8} {rdr.GetInt32(2), 8}");
}
我们将 SQL 语句返回的数据打印到终端。
$ dotnet run id name price 1 Audi 52642 2 Mercedes 57127 3 Skoda 9000 4 Volvo 29000 5 Bentley 350000
来源
在本文中，我们展示了如何在 C# 中对 SQLite 数据库进行编程。
作者
列出所有 C# 教程。