C#SQLite教程展示了如何在C#中对SQLite数据库进行编程。
SQLite
SQLite是一个嵌入式关系数据库引擎。它是一个独立的、无服务器的、零配置的和事务性的SQL数据库引擎。SQLite实现了SQL的大部分SQL-92标准。SQLite引擎不是一个独立的进程。相反,它静态或动态链接到应用程序中。SQLite数据库是单个普通磁盘文件,可以位于目录层次结构中的任何位置。
ADO.NET
ADO.NET
是.NET的重要组成部分。它是一种统一访问关系数据库、XML文件和其他应用程序数据的规范。从程序员的角度来看,它是一组用于处理数据库和其他数据源的库和类。System.Data.SQLite.Core
是SQLite数据库的ADO.NET规范的实现。它是用C#语言编写的驱动程序,适用于所有.NET语言。
$ dotnet add package System.Data.SQLite.Core
我们需要将包包含到我们的.NETCore项目中。
SQLiteConnection
、SQLiteCommand
、SQLiteDataReader
、SQLiteDataAdapter
是.NET数据提供者模型的核心元素。SQLiteConnection
创建到特定数据源的连接。SQLiteCommand
对象针对数据源执行SQL语句。SQLiteDataReader
读取数据流来自数据源。SQLiteDataAdapter
是DataSet
和数据源之间的中介。它填充一个DataSet
并使用数据源解析更新。
DataSet
对象用于离线处理大量数据。它是一种断开连接的数据表示,可以保存来自各种不同来源的数据。SQLiteDataReader
和DataSet
都用于处理数据;它们在不同的情况下使用。如果我们只需要读取查询结果,SQLiteDataReader
是更好的选择。如果我们需要更广泛的数据处理,或者我们想将Winforms控件绑定到数据库表,则首选DataSet
。
SQLiteC#版本
如果是第一个程序,我们检查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
表已创建。INTEGERPRIMARYKEY
列在SQLite中自动递增。
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;否则为假。我们可以使用数组索引符号检索值,或使用特定方法以其本机数据类型访问列值。后者效率更高。
$ 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}");
我们使用thereader的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#教程。