一、引言

在.NET开发中，SQLite作为一种轻量级、高效且易于集成的关系型数据库，常被用于桌面应用、移动应用等场景中的本地数据存储。SQLite-net ORM库以其简单、强大、跨平台的特性，成为.NET开发者操作SQLite数据库的首选工具之一。本文将详细介绍SQLite-net ORM的使用方法，并展示如何封装常用数据库操作，以提高开发效率和代码可维护性。

二、SQLite-net ORM简介

SQLite-net是一个轻量级的ORM库，专门用于在.NET应用程序中访问和操作SQLite数据库。它具有以下特点：

易于集成：可以非常容易地与现有.NET项目集成，并在所有.NET平台上运行。
性能高效：对SQLite的包装非常薄，不会成为查询性能的瓶颈。
安全操作：提供简单的方法来安全执行CRUD（创建、读取、更新、删除）操作和查询，使用参数化查询，有效避免SQL注入等安全问题。
反射驱动：包含一个小型的反射驱动ORM层，无需对数据模型进行重大更改即可与之工作。

三、安装SQLite-net

可以通过NuGet包管理器安装SQLite-net。搜索sqlite-net-pcl，选择最新稳定版本进行安装。例如，使用.NET CLI方式安装：

dotnet add package sqlite-net-pcl

或者使用Package Manager方式：

Install-Package sqlite-net-pcl

安装完成后，即可在项目中引用并使用SQLite-net。

四、定义实体类

在使用SQLite-net ORM之前，需要定义与数据库表对应的实体类。例如，定义一个User实体类：

public class User
{
    [PrimaryKey, AutoIncrement]
    public int Id { get; set; }
    public string Name { get; set; }
    public string Email { get; set; }
}

这里使用了PrimaryKey和AutoIncrement属性来指定主键和自增字段。

五、封装常用方法

为了提高代码的复用性和可维护性，可以封装SQLite-net ORM的常用方法。以下是一个简单的封装示例，创建一个SQLiteHelper类：

public class SQLiteHelper<T> where T : new()
{
    private readonly string _databasePath;
    private readonly SQLiteConnection _connection;

    public SQLiteHelper(string databasePath)
    {
        _databasePath = databasePath;
        _connection = new SQLiteConnection(_databasePath);
        _connection.CreateTable<T>();
    }

    public int Insert(T item)
    {
        return _connection.Insert(item);
    }

    public int Delete(int id)
    {
        return _connection.Delete<T>(id);
    }

    public int Update(T item)
    {
        return _connection.Update(item);
    }

    public List<T> Query(Expression<Func<T, bool>> predExpr)
    {
        return _connection.Table<T>().Where(predExpr).ToList();
    }

    public List<T> QueryAll()
    {
        return _connection.Table<T>().ToList();
    }
}

这个SQLiteHelper类提供了插入、删除、更新和查询数据的方法。使用时只需传入数据库路径和实体类类型即可。

六、使用示例

以下是如何使用封装好的SQLiteHelper类进行数据库操作的示例：

// 创建SQLiteHelper实例
var dbHelper = new SQLiteHelper<User>("path/to/your/database.db");

// 插入数据
var newUser = new User { Name = "张三", Email = "zhangsan@example.com" };
int insertResult = dbHelper.Insert(newUser);
Console.WriteLine($"插入结果：{insertResult}");

// 查询所有数据
List<User> users = dbHelper.QueryAll();
foreach (var user in users)
{
    Console.WriteLine($"ID：{user.Id}, 姓名：{user.Name}, 邮箱：{user.Email}");
}

// 根据条件查询数据
var queryResult = dbHelper.Query(u => u.Name == "张三");
foreach (var user in queryResult)
{
    Console.WriteLine($"查询到的用户：ID：{user.Id}, 姓名：{user.Name}, 邮箱：{user.Email}");
}

// 更新数据
var userToUpdate = users[0];
userToUpdate.Email = "updated@example.com";
int updateResult = dbHelper.Update(userToUpdate);
Console.WriteLine($"更新结果：{updateResult}");

// 删除数据
int deleteResult = dbHelper.Delete(users[0].Id);
Console.WriteLine($"删除结果：{deleteResult}");

通过封装后的SQLiteHelper类，可以非常方便地进行数据库的CRUD操作，代码更加简洁和易于维护。

七、总结

SQLite-net ORM以其简单、高效和安全的特点，为.NET开发者提供了一个强大的SQLite数据库操作工具。通过封装常用方法，可以进一步提高开发效率和代码质量。在实际项目中，可以根据具体需求对封装的方法进行扩展和优化，以满足不同的业务场景。

ITPub博客

SQLite-net ORM并封装常用方法