C#如何连接SQLite数据库 C# System.Data.SQLite的使用方法

来源:这里教程网 时间:2026-02-21 17:31:40 作者:

在C#中连接和操作SQLite数据库,最常用的方式是使用 System.Data.SQLite 库。它是一个开源的 ADO.NET 数据提供程序,专为 SQLite 设计,支持 .NET Framework 和 .NET Core/.NET 5+。以下是详细的使用方法。

1. 安装 System.Data.SQLite

要使用 System.Data.sqlite,你需要先安装对应的 NuGet 包:

打开 Visual Studio → 右键项目 → 管理 NuGet 程序包 → 搜索并安装 System.Data.SQLite

或者通过 NuGet 包管理器控制台运行命令:

Install-Package System.Data.SQLite

安装后会自动添加对 System.Data.SQLite.dll 的引用。

2. 引入命名空间

在代码文件顶部引入必要的命名空间:

using System.Data.SQLite;

3. 连接 SQLite 数据库

使用 SQLiteConnection 类来建立数据库连接。如果数据库文件不存在,可以自动创建。

示例:连接到本地数据库文件(若不存在则创建)

string connectionString = "Data Source=example.db;Version=3;New=True;Compress=True;";
using (var connection = new SQLiteConnection(connectionString))
{
    connection.Open();
    Console.WriteLine("数据库连接成功!");
}

常见连接字符串参数说明:

Data Source=example.db:指定数据库文件路径 Version=3:使用 SQLite3 版本 New=True:强制创建新数据库(可配合其他参数使用) FailIfMissing=False:文件不存在时不报错(默认会尝试创建)

4. 创建表并插入数据

使用 SQLiteCommand 执行 SQL 语句。

using (var connection = new SQLiteConnection("Data Source=test.db;Version=3;"))
{
    connection.Open();
    // 创建表
    string createTableSql = "CREATE TABLE IF NOT EXISTS Users (Id INTEGER PRIMARY KEY, Name TEXT, Age INTEGER)";
    using (var cmd = new SQLiteCommand(createTableSql, connection))
    {
        cmd.ExecuteNonQuery();
    }
    // 插入数据
    string insertSql = "INSERT INTO Users (Name, Age) VALUES (@name, @age)";
    using (var cmd = new SQLiteCommand(insertSql, connection))
    {
        cmd.Parameters.AddWithValue("@name", "张三");
        cmd.Parameters.AddWithValue("@age", 25);
        cmd.ExecuteNonQuery();
    }
}

5. 查询数据

使用 SQLiteCommand 配合 SQLiteDataReader 读取查询结果。

string selectSql = "SELECT Id, Name, Age FROM Users";
using (var cmd = new SQLiteCommand(selectSql, connection))
using (var reader = cmd.ExecuteReader())
{
    while (reader.Read())
    {
        int id = reader.GetInt32("Id");
        string name = reader.GetString("Name");
        int age = reader.GetInt32("Age");
        Console.WriteLine($"ID: {id}, 姓名: {name}, 年龄: {age}");
    }
}

6. 使用事务处理

对于多条写入操作,建议使用事务确保数据一致性。

using (var transaction = connection.BeginTransaction())
{
    try
    {
        var cmd = connection.CreateCommand();
        cmd.Transaction = transaction;
        cmd.CommandText = "INSERT INTO Users (Name, Age) VALUES ('李四', 30)";
        cmd.ExecuteNonQuery();
        cmd.CommandText = "INSERT INTO Users (Name, Age) VALUES ('王五', 28)";
        cmd.ExecuteNonQuery();
        transaction.Commit();
    }
    catch
    {
        transaction.Rollback();
        throw;
    }
}

7. 注意事项

确保目标机器上有正确的运行时支持(x86/x64),System.Data.SQLite 内部依赖原生库 在 .NET Core 或跨平台项目中,也可考虑使用 Microsoft.Data.Sqlite(轻量且跨平台友好) 避免拼接 SQL 字符串,始终使用参数化查询防止 SQL 注入 使用 using 语句确保连接和命令对象被正确释放 基本上就这些。System.Data.SQLite 功能完整,适合中小型项目快速集成 SQLite 支持。

相关推荐

热文推荐