C# SQLite

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

我们需要将包包含到我们的 .NET Core 项目中。

SQLiteConnection, SQLiteCommand, SQLiteDataReader, SQLiteDataAdapter是 .NET 数据提供者模型的核心元素。SQLiteConnection创建与特定数据源的连接。该SQLiteCommand对象针对数据源执行 SQL 语句。从SQLiteDataReader数据源读取数据流。A是数据源和数据源SQLiteDataAdapter之间的中介。DataSet它使用数据源填充DataSet 并解析更新。

该DataSet对象用于处理大量数据的离线工作。它是一种不连贯的数据表示，可以保存来自各种不同来源的数据。两者SQLiteDataReader都DataSet用于处理数据；它们在不同的情况下使用。如果我们只需要读取查询的结果，那SQLiteDataReader是更好的选择。如果我们需要更广泛的数据处理，或者我们想要将 Winforms 控件绑定到数据库表，DataSet则首选。

SQLite C# 版本

如果是第一个程序，我们检查 SQLite 数据库的版本。

程序.cs

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 创建表

在下面的示例中，我们创建一个数据库表并用数据填充它。

程序.cs

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();

首先，如果表已经存在，我们将其删除。ExecuteNonQuery如果我们不想要结果集，例如 for DROP、INSERT或DELETEstatements ，我们将使用该方法。

cmd.CommandText = @"CREATE TABLE cars(id INTEGER PRIMARY KEY,price INT)";
cmd.ExecuteNonQuery();

表cars已创建。该INTEGER PRIMARY KEY 列在 SQLite 中自动递增。

cmd.CommandText = "INSERT INTO cars(name,57127)";
cmd.ExecuteNonQuery();

我们在表中插入两行。

$ dotnet run
Table cars created

我们运行程序。

$ sqlite3 test.db

我们用工具打开test.db数据库sqlite3。

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 准备好的语句

准备好的语句提高了安全性和性能。当我们编写准备好的语句时，我们使用占位符而不是直接将值写入语句。

程序.cs

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)";

当我们编写准备好的语句时，我们使用占位符而不是直接将值写入语句。准备好的语句速度更快，可以防止 SQL 注入攻击。@nameand是占位符，@price 稍后会填充。

cmd.Parameters.AddWithValue("@name",36600);
cmd.Prepare();

值绑定到占位符。

cmd.ExecuteNonQuery();

准备好的语句被执行。当我们不期望返回任何数据时，我们使用对象的ExecuteNonQuery 方法。SQLiteCommand

sqlite> SELECT * FROM cars WHERE id=8;
id          name        price
----------  ----------  ----------
8           Volkswagen  21600

我们验证该行是否插入正常。

C# SQLiteDataReader

这SQLiteDataReader是一个用于从数据库中检索数据的类。它与SQLiteCommand类一起用于执行 SELECT 语句，然后访问返回的行。它提供对查询结果的快速、只进、只读访问。这是从表中检索数据的最有效方式。

SQLiteDataReader 我们通过调用对象的ExecuteReader方法来创建一个实例SQLiteCommand。在SqlDataReader使用时，关联SQLiteConnection服务于 SqlDataReader. SQLiteConnection除了关闭它之外，不能进行其他操作。

程序.cs

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对象，我们调用对象的ExecuteReader方法SQLiteCommand。

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 列标题

在以下示例中，我们使用数据库表中的数据打印列标题。

程序.cs

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),8}");

我们使用GetNamereader 的方法获取列的名称。

while (rdr.Read())
{
    Console.WriteLine($@"{rdr.GetInt32(0),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# SQLite

SQLite

ADO.NET

SQLite C# 版本

C# SQLite 创建表

C# SQLite 准备好的语句

C# SQLiteDataReader

C# SQLite 列标题

相关文章