Xamarin.Forms 使用本地数据库之 SQLite

前言

　　Xamarin.Forms支持使用SQLite数据库引擎。本文介绍了Xamarin.Forms应用程序如何读取和写入数据到使用SQLite.Net的本地SQLite数据库。

在Xamarin.Forms项目中引用 SQLite 包

　　要使用 SQLite ， 我们先要引用 SQLite 的引用包。使用 NuGet 的搜索功能查找sqlite net pcl并安装最新的包：

连接 SQLite 本地数据库并创建数据表

//SQLite 数据库地址
var path = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "sqlite.db3");
using (SQLiteConnection con = new SQLiteConnection(path))
{

}

通过以上代码，创建一个名为 "sqlite.db3" 的 SQLite 本地数据库，并进行连接操作。（本地数据库存在时，直接连接）

可以看到 SQLiteConnection 对象的 DatabasePath 的路径为：/data/user/0/com.companyname.Samples/files/.local/share/sqlite.db3 。至此我们创建本地数据库及连接本地数据库成功！

在本文中主要介绍通过 SQLite.NET ORM 操作数据库。

//SQLite 数据库地址
var path = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "sqlite.db3");
using (SQLiteConnection con = new SQLiteConnection(path))
{
    // ORM方式
    con.DropTable<Student>();
    con.DropTable<Subject>();
    con.DropTable<StudentSubject>();
    con.CreateTables<Student, Subject, StudentSubject>();

    sl.Children.Add(new Label() { Text = "建表完成" });
}

通过 DropTable<T>() 删除表。

通过 CreateTable<T>() 或 CreateTables<T,T,T>() 创建表。

public class Student
{
    [PrimaryKey]
    public string id { get; set; }
    public string name { get; set; }
    public int age { get; set; }
}

public class Subject
{
    [PrimaryKey]
    public string id { get; set; }
    public string name { get; set; }
}

public class StudentSubject
{
    [PrimaryKey]
    public string id { get; set; }
    public string student_id { get; set; }
    public string subject_id { get; set; }
}

在类 Student，Subject，StudentSubject 中，通过在属性上标记 [PrimaryKey] 标示 id 列为 主键列。（主键列很重要，在修改，删除操作中会用到）

在 SQLite 本地数据库中 INSERT 数据

var path = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "sqlite.db3");
using(var con = new SQLiteConnection(path))
{
    // ORM方式
    var list = new List<object>();
    list.Add(new Student() { id = "stu_1", name = "张三", age =  });

    list.Add(new Subject() { id = "subject_1", name = "计算机" });
    list.Add(new Subject() { id = "subject_2", name = "数学" });
    list.Add(new Subject() { id = "subject_3", name = "英语" });

    list.Add(new StudentSubject() { id = "ss_1", student_id = "stu_1", subject_id = "subject_1" });
    list.Add(new StudentSubject() { id = "ss_2", student_id = "stu_1", subject_id = "subject_2" });
    list.Add(new StudentSubject() { id = "ss_3", student_id = "stu_1", subject_id = "subject_3" });

    var result = con.InsertAll(list);

    sl.Children.Add(new Label() { Text = result >  ? "插入成功" : "插入失败" });
}

通过 Insert(Object object) 或 InsertAll(IEnumerable objects) 或 Execute(string query, params object[] args) 进行 新增操作；

在 SQLite 本地数据库中 SELECT 数据

var path = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "sqlite.db3");
using (var con = new SQLiteConnection(path))
{
    // ORM方式
    // var student = con.Table<Student>().FirstOrDefault();
    // SQL语句方式
    var student = con.Query<Student>("SELECT id,name,age FROM Student LIMIT 0,1;").FirstOrDefault();

    // ORM方式
    // var studentSubjects = con.Table<StudentSubject>().ToList();
    // SQL语句方式
    var studentSubjects = con.Query<StudentSubject>("SELECT student_id,subject_id FROM StudentSubject;").ToList();

    if (student == null)
    {
        sl.Children.Add(new Label() { Text = "无数据" });
        return;
    }

    sl.Children.Add(new Label() { Text = string.Format("student.id = {0}", student.id) });
    sl.Children.Add(new Label() { Text = string.Format("student.name = {0}", student.name) });
    sl.Children.Add(new Label() { Text = string.Format("student.age = {0}", student.age) });

    studentSubjects.ForEach(ss =>
    {
        // ORM方式
        // var subject = con.Table<Subject>().Where(o => o.id.Equals(ss.subject_id)).FirstOrDefault();
        // SQL语句方式
        var subject = con.Query<Subject>("SELECT * FROM Subject WHERE id = ?", new object[] { ss.subject_id }).FirstOrDefault();

        sl.Children.Add(new Label() { Text = string.Format("student.subject = {0}", subject.name) });
    });
}    

通过 Query<T>(string query, params object[] args) 或 TableQuery<T> Table<T>() 进行 查询操作；

在 SQLite 本地数据库中 UPDATE 数据

var path = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "sqlite.db3");
using (var con = new SQLiteConnection(path))
{
    // ORM方式
    var student = con.Table<Student>().FirstOrDefault();
    if (student == null)
    {
        sl.Children.Add(new Label() { Text = "无数据" });
        return;
    }

    student.name = "我是修改后的姓名";
    var result = con.Update(student);

    sl.Children.Add(new Label() { Text = result >  ? "修改成功" : "修改失败" });
} 

通过 Update(object obj) 或 Execute(string query, params object[] args) 进行 修改操作；

在 SQLite 本地数据库中 DELETE 数据

var path = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "sqlite.db3");
using (var con = new SQLiteConnection(path))
{
    var student = con.Table<Student>().FirstOrDefault();
    if (student == null)
    {
        sl.Children.Add(new Label() { Text = "无数据" });
        return;
    }

    // ORM方式
    // var result = con.Delete(student);
    // SQL语句方式
    var result = con.Execute("DELETE FROM Student WHERE id = ?", new object[] { student.id });

    sl.Children.Add(new Label() { Text = result >  ? "删除成功" : "删除失败" });
}

通过 Delete<T>(object primaryKey) 或 Execute(string query, params object[] args) 进行 删除操作；

结束语

本文所有代码都在 https://github.com/hexu6788/XamarinForms-Samples

如果你觉得本篇文章对您有帮助的话，感谢您的【推荐】。

如果你对 .NET 或 Xamarin 有兴趣的话可以关注我，我会定期的在博客分享我的学习心得。

本文地址：https://www.cnblogs.com/hexu6788/p/10102942.html

作者博客：何旭

欢迎转载，请在明显位置给出出处及链接