• SQLite簡介
  • 存盤類
  • 親和型別
• 參考System.Data.SQLite.dll
  • 軟體包分類
  • 使用本機庫預加載
  • 常用部署包
• 工具類
• 參考資料

SQLite簡介

SQLite是一款輕型的資料庫，一個資料庫就是一個檔案，詳細介紹參考官網：https://www.sqlite.org/index.html

SQLite 資料型別是一個用來指定任何物件的資料型別的屬性，SQLite 中的每一列，每個變數和運算式都有相關的資料型別，
您可以在創建表的同時使用這些資料型別，SQLite 使用一個更普遍的動態型別系統，在 SQLite 中，值的資料型別與值本身是相關的，而不是與它的容器相關，

SQLite資料與常見的MySQL、SQL等的資料庫不一樣，它是動態型別資料庫，每個值在資料庫占的存盤空間根據值的大小確定，使用時需要注意資料型別的問題，

存盤類

每個存盤在 SQLite 資料庫中的值都具有以下存盤類之一：

親和型別

SQLite支持列的親和型別概念，任何列仍然可以存盤任何型別的資料，當資料插入時該欄位的資料將會優先采用親和型別作為該值的存盤方式，
創建 SQLite3 表時可使用的各種資料型別名稱及相應的親和型別，如下：

參考System.Data.SQLite.dll

在C#中使用SQLite資料庫需要參考System.Data.SQLite.dll，下載鏈接：http://system.data.sqlite.org/index.html/doc/trunk/www/downloads.wiki

注：System.Data.SQLite是SQLite的ADO.NET提供程式，兩者是兩個不同的開源專案，現在System.Data.SQLite的開發和維護作業大部分由SQLite開發團隊執行，

System.Data.SQLite的下載頁面選項太多，一般人進來都不清楚要下載那些內容，下面對下載界面中的軟體包做一個簡單介紹，

軟體包分類

下載內容按型別分為安裝包、非靜態連接的二進制包和靜態連接的二進制包三種，區別如下：

• 安裝程式包僅用于在開發人員計算機上安裝，然后僅在需要VisualStudio的設計時組件時安裝，不建議安裝在客戶機器上（理論上也可以），
• 安裝包會安裝相關的動態庫到系統內，并注冊到GAC（Global Assembly Cache），
• 二進制軟體包旨在供開發人員使用，以便獲得開發所需的匯編二進制檔案，并通過XCOPY部署將其應用程式部署到客戶機上，
• 兩種二進制包的區別在于非托管部分的連接方式不同，非靜態連接的二進制包在使用時需要VC運行時庫的支持，

注：如果所有目標機器已經安裝了VisualC++運行時，或者可以容易地部署，則應該避免“靜態”包，

每個型別都按.NET版本分成了若干小組，每個.NET版本又分為32位和64位兩組：

• 支持的.NET版本有 2.0 SP2 、 3.5 SP2 、4.0 、 4.5 、 4.5.1 、4.6 ，
• 選用32位還是64位是根據使用系統來決定的，如開發時是64位（使用64位dll）系統而發布后運行在32位（使用32位dll）系統上，

注：雖然.NET高版本兼容低版本，但強烈建議選擇與目標.NET Framework版本匹配的包，

在每個.NET版本-位數分組中都有2個檔案包，一個帶有“bundle”字樣，另一個沒有：

• 帶有“bundle”字樣的表示動態庫是按混合模式編譯的，在使用的時候只需要System.Data.SQLite.dll就可以了，
• 不帶“bundle”的則是將非托管部分和托管部分分別編譯，System.Data.SQLite.dll不能獨立使用，還需要有SQLite.Interop.dll才能使用，

注：除非認為絕對必要，否則應避免使用“bundle”包，

根據上面的介紹，如果開發機器和客戶機器可能具有不同的處理器體系結構，則可能需要一個以上的二進制程式包，

使用本機庫預加載

本機庫預加載功能從1.0.80.0版本開始可用，并且默認情況下已啟用，能夠自動適應當前系統的位數，為了利用此功能，必須將單獨的托管程式集和互操作程式集與XCOPY部署一起使用（混合模式程式集、安裝軟體包部署不支持此功能），
使用本機庫預加載功能時，應用程式部署看起來如下（ bin 表示將在目標計算機上部署應用程式二進制檔案的目錄）：

• bin \ App.exe（可選，僅受管應用程式可執行程式集）
• bin \ App.dll（可選，僅托管應用程式庫程式集）
• bin \ System.Data.SQLite.dll（必需，僅受管核心程式集）
• bin \ System.Data.SQLite.Linq.dll（可選，僅托管LINQ程式集）
• bin \ System.Data.SQLite.EF6.dll（可選，僅托管EF6程式集）
• bin \ x86 \ SQLite.Interop.dll（必需，x86本機互操作程式集）
• bin \ x64 \ SQLite.Interop.dll（必需，x64本機互操作程式集）

啟用本機庫預加載功能并顯示上面的應用程式部署后，System.Data.SQLite僅限托管程式集將嘗試自動檢測當前行程的處理器體系結構并預加載適當的本機庫，此時不用考慮客戶機器的是64位還是32位，

常用部署包

我把.NET的4.0 、4.5版本對應的軟體包按本機庫預加載功能的要求重新組裝，使用時直接復制到Debug目錄下即可：

• sqlite-netFx45-binary-Win32-x64-2012-1.0.113.0.zip 提取碼: r4yy
• sqlite-netFx40-binary-Win32-x64-2010-1.0.113.0.zip 提取碼: j88h
• sqlite-netFx45-static-binary-Win32-x64-2012-1.0.113.0.zip 提取碼: 33kp
• sqlite-netFx40-static-binary-Win32-x64-2010-1.0.113.0.zip 提取碼: iqr2

注：官方建議不使用靜態的二進制包，我個人則喜歡用靜態的二進制包，這樣就不用考慮客戶機器上是否安裝有對應的VC運行時庫了，

工具類

工具類大部分內容來自c# Sqlite幫助類，考慮到SQLite是一個資料庫一個檔案、一個專案可能需要多個資料庫，我將工具類改為通過物件實體操作資料庫并提供一個靜態的物件實體字典，
工具類代碼如下：

public class SQLiteHelper
{
    /// <summary>
    /// 資料庫串列
    /// </summary>
    public static Dictionary<string, SQLiteHelper> DataBaceList = new Dictionary<string, SQLiteHelper>();

    /// <summary>
    /// 建構式
    /// </summary>
    /// <param name="filename">資料庫檔案名</param>
    public SQLiteHelper(string filename=null) 
    {
        DataSource = filename;                     
    }

    /// <summary>
    /// 資料庫地址
    /// </summary>
    public string DataSource { get; set; }        

    /// <summary>
    /// 創建資料庫，如果資料庫檔案存在則忽略此操作
    /// </summary>
    public void CreateDataBase() 
    {
        string path = Path.GetDirectoryName(DataSource);
        if ((!string.IsNullOrWhiteSpace(path)) && (!Directory.Exists(path))) Directory.CreateDirectory(path);
        if (!File.Exists(DataSource)) SQLiteConnection.CreateFile(DataSource);          
    }



    /// <summary>
    /// 獲得連接物件
    /// </summary>
    /// <returns>SQLiteConnection</returns>       
    public SQLiteConnection GetSQLiteConnection()
    {
        string connStr =string.Format("Data Source={0}", DataSource);            
        var con = new SQLiteConnection(connStr);
        return con;
    }

    /// <summary>
    /// 準備操作命令引數
    /// </summary>
    /// <param name="cmd">SQLiteCommand</param>
    /// <param name="conn">SQLiteConnection</param>
    /// <param name="cmdText">Sql命令文本</param>
    /// <param name="data">引數陣列</param>
    private static void PrepareCommand(SQLiteCommand cmd, SQLiteConnection conn, string cmdText, Dictionary<String, String> data)
    {
        if (conn.State != ConnectionState.Open)
            conn.Open();
        cmd.Parameters.Clear();
        cmd.Connection = conn;
        cmd.CommandText = cmdText;
        cmd.CommandType = CommandType.Text;
        cmd.CommandTimeout = 30;
        if (data != null && data.Count >= 1)
        {
            foreach (KeyValuePair<String, String> val in data)
            {
                cmd.Parameters.AddWithValue(val.Key, val.Value);
            }
        }
    }

    /// <summary>
    /// 查詢，回傳DataSet
    /// </summary>
    /// <param name="cmdText">Sql命令文本</param>
    /// <param name="data">引數陣列</param>
    /// <returns>DataSet</returns>
    public DataSet ExecuteDataset(string cmdText, Dictionary<string, string> data = https://www.cnblogs.com/timefiles/archive/2021/04/14/null)
    {
        var ds = new DataSet();
        using (SQLiteConnection connection = GetSQLiteConnection())
        {
            var command = new SQLiteCommand();
            PrepareCommand(command, connection, cmdText, data);
            var da = new SQLiteDataAdapter(command);
            da.Fill(ds);
        }
        return ds;
    }

    /// 

    /// 查詢，回傳DataTable
    /// 
    /// 
    /// 回傳一行資料
    /// 
    ///  0 && ds.Tables[0].Rows.Count > 0)
            return ds.Tables[0].Rows[0];
        return null;
    }

    /// 

    /// 執行資料庫操作
    /// 
    /// 
    /// 回傳SqlDataReader物件
    /// 
    /// 
    /// 回傳結果集中的第一行第一列，忽略其他行或列
    /// 
    /// 
    /// 分頁查詢
    /// 
    /// 

static void Main(string[] args)
{
    SQLiteHelper testDb = new SQLiteHelper("test.db");
    SQLiteHelper.DataBaceList.Add("TEST", testDb);

    //建庫
    testDb.CreateDataBase();

    //建表            
    StringBuilder sbr = new StringBuilder();
    sbr.AppendLine("CREATE TABLE IF NOT EXISTS `test_table`(");
    sbr.AppendLine("`id` INTEGER PRIMARY KEY AUTOINCREMENT,");//自增id主鍵
    sbr.AppendLine("`name` VARCHAR(100) NOT NULL,");
    sbr.AppendLine("`password` VARCHAR(40) NOT NULL,");
    sbr.AppendLine("`create_time` datetime DEFAULT CURRENT_TIMESTAMP,");
    sbr.AppendLine("`update_time` datetime DEFAULT CURRENT_TIMESTAMP );");            
    sbr.AppendLine();

    sbr.AppendLine("CREATE TRIGGER  IF NOT EXISTS `trigger_test_table_update_time` ");//觸發器-自動更新update_time
    sbr.AppendLine("AFTER UPDATE ON `test_table` ");
    sbr.AppendLine("FOR EACH ROW ");
    sbr.AppendLine("BEGIN ");
    sbr.AppendLine("UPDATE `test_table` SET `update_time` = CURRENT_TIMESTAMP WHERE id = old.id; ");
    sbr.AppendLine("END;");

    string cmdText = sbr.ToString();
    int val = testDb.ExecuteNonQuery(cmdText);            
    Console.WriteLine("影響行數：" + val);

    //增
    sbr.Clear();
    sbr.Append("INSERT INTO test_table (name,password) VALUES ");
    sbr.Append("(11,111), ");
    sbr.Append("(12,222); ");
    cmdText = sbr.ToString();
    val = testDb.ExecuteNonQuery(cmdText);
    Console.WriteLine("影響行數：" + val);

    //刪
    sbr.Clear();
    sbr.Append("DELETE FROM test_table ");
    sbr.Append("WHERE id=1;");
    cmdText = sbr.ToString();
    val = testDb.ExecuteNonQuery(cmdText);
    Console.WriteLine("影響行數：" + val);

    //改
    sbr.Clear();
    sbr.Append("UPDATE test_table SET ");
    sbr.Append("name='13', ");
    sbr.Append("password='333' ");
    sbr.Append("WHERE id=@id;");
    cmdText = sbr.ToString();
    Dictionary<string, string> data = https://www.cnblogs.com/timefiles/archive/2021/04/14/new Dictionary();
    data.Add("@id", "2");           
    val = testDb.ExecuteNonQuery(cmdText, data);
    Console.WriteLine("影響行數：" + val);

    //查
    sbr.Clear();
    sbr.Append("SELECT name,password FROM test_table ");
    sbr.Append("WHERE id=@id;");
    cmdText = sbr.ToString();
    DataTable dt = testDb.ExecuteDataTable(cmdText, data);
    Console.WriteLine("結果行數：" + dt.Rows.Count);                                   

    //洗掉表
    sbr.Clear();
    sbr.Append("DROP TABLE test_table;");
    cmdText = sbr.ToString();
    val = SQLiteHelper.DataBaceList["TEST"].ExecuteNonQuery(cmdText);
    Console.WriteLine("影響行數：" + val);

    //重組資料庫
    SQLiteHelper.DataBaceList["TEST"].ResetDataBass();

    Console.ReadKey();
}