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 = 18 });

    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 > 0 ? "插入成功" : "插入失敗" });
}

通過 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 > 0 ? "修改成功" : "修改失敗" });
} 

通過 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 > 0 ? "刪除成功" : "刪除失敗" });
}

通過 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

作者博客：何旭

歡迎轉載，請在明顯位置給出出處及鏈接