簡介這份資源面向使用C# 2012與VS2012開發(fā)64位Windows應用的開發(fā)者聚焦SQLite嵌入式數據庫的調用與密碼設置適合需要輕量級本地數據存儲方案的中級學習者。包內共42個文件以cs源碼、config配置、dll程序集、resx資源、exe可執(zhí)行文件及sln解決方案為主壓縮包約2.48MB結構完整可直接編譯運行。項目圍繞SQLiteConnection連接字符串、SQLiteCommand執(zhí)行建表與增刪改查、SQLiteDataReader讀取結果等核心操作展開并演示在連接串中加入密碼參數實現數據庫加密保護幫助讀者理解SQLite本身不直接支持庫級密碼時的替代思路。已有850人學習下載可作為C#桌面端數據管理、安全存儲與VS2012工程配置的參考范例便于快速遷移到實際項目中。1. 從一次老項目維護說起這套 64 位 C# 調用 SQLite 的源碼到底能干什么前陣子幫朋友收拾一個 2013 年上線的工控上位機機器是 Win7 64 位代碼是 VS2012 寫的 C#數據庫用的是 SQLite。需求很樸素把歷史報警記錄從本地文件挪進數據庫還要給數據庫加個密碼防止現場人員直接拿工具打開改數據。問題來了——網上搜到的 C# SQLite 示例十有八九是 32 位的System.Data.SQLite.dll扔進 64 位項目里一跑就報BadImageFormatException折騰半天才發(fā)現是位數不匹配。這套「64 位 C#2012 調用 SQLite 數據庫源碼含設置密碼」正好踩在這個點上它給的是能在 VS2012 下直接編譯的 64 位工程封裝了增刪改查還帶了一個給 SQLite 數據庫設置密碼的完整流程。適合誰手上還有 VS2012 老項目要維護的 C# 上位機開發(fā)者、需要給本地庫加訪問口令的工控/醫(yī)療設備軟件維護人員以及想搞清楚 SQLite 加密到底怎么落地的人。下面我按「先跑通、再講參數、最后說坑」的順序拆一遍。2. 環(huán)境搭起來VS2012 64 位 SQLite 的依賴選擇與工程配置2.1 為什么必須是 64 位以及依賴包怎么選先說清楚一個容易翻車的點SQLite 本身是 C 寫的但 .NET 這邊用的是System.Data.SQLite這個托管封裝它內部要 P/Invoke 一個原生SQLite.Interop.dll。這個原生 DLL 分 x86 和 x64 兩個版本托管 DLL 會根據當前進程位數去加載對應目錄下的 interop。如果你的 C# 工程編譯目標是 AnyCPU在 64 位系統(tǒng)上默認跑成 64 位進程但引用的卻是 32 位 interop運行時就會拋BadImageFormatException或者Unable to load DLL SQLite.Interop.dll。所以第一件事不是寫代碼是把位數對齊。選包的時候我一般直接去System.Data.SQLite的官方發(fā)布頁拿帶bundle的包比如System.Data.SQLite.dll加上x64、x86兩個子目錄的 interop。bundle 版的好處是托管和原生打包在一起省得自己配dll搜索路徑。VS2012 對應的是 .NET Framework 4.5選包時注意別拿只支持 .NET Standard 的新版本那個在 VS2012 里根本引不進來。工程配置上右鍵項目 → 屬性 → 生成 → 目標平臺明確選x64不要留 AnyCPU。這一步是血淚經驗AnyCPU 在開發(fā)機上可能碰巧能跑一到客戶現場 32 位老機器上就崩。2.2 把 interop 放到正確位置一個能直接抄的目錄結構很多人引完 DLL 就以為完事了結果一運行就找不到 interop。原因是System.Data.SQLite默認按x64\SQLite.Interop.dll和x86\SQLite.Interop.dll的相對路徑去找。所以你的輸出目錄里必須有這兩個子文件夾。我一般這樣組織# 工程根目錄下的 libs 文件夾放 SQLite 相關依賴 libs/ ├── System.Data.SQLite.dll ├── x64/ │ └── SQLite.Interop.dll └── x86/ └── SQLite.Interop.dll然后在 VS2012 里對這三個 DLL 分別設置「復制到輸出目錄 如果較新則復制」。注意x64和x86兩個文件夾要作為內容保留目錄結構不能只復制文件本身。如果你只做 64 位可以只留x64但保留x86對以后兼容沒壞處。配置完編譯一次去bin\x64\Debug下確認SQLite.Interop.dll確實在x64子目錄里。這一步驗證過了后面 90% 的「找不到 DLL」問題都不會出現。2.3 連接字符串怎么寫密碼參數放哪SQLite 的連接字符串和 SQL Server 那種不一樣它沒有獨立的賬號密碼概念密碼是通過連接字符串里的Password關鍵字傳的?；A寫法// 普通無密碼連接 string connStr Data Source.\data\history.db;Version3;; // 帶密碼連接數據庫已加密時 string connStrPwd Data Source.\data\history.db;Version3;PasswordMyPass123;;參數說明Data Source是庫文件路徑相對路徑以程序工作目錄為基準工控項目里我建議一律用AppDomain.CurrentDomain.BaseDirectory拼絕對路徑避免服務方式啟動時工作目錄不對。Version3表示 SQLite 3 格式現在基本都是 3。Password就是加密口令注意這個口令一旦設置用普通 SQLite 工具比如 DB Browser for SQLite打開會提示「file is not a database」這是正常的因為文件頭已經被加密了。提示Password只在數據庫本身已加密或你要新建加密庫時才有意義。對一個沒加密的庫直接帶Password去連會報「file is encrypted or is not a database」別以為是密碼錯了。3. 核心代碼拆解增刪改查封裝與設置密碼的完整流程3.1 一個夠用的 SQLiteHelper 封裝源碼里通常會給一個SQLiteHelper類把連接、執(zhí)行、查詢包起來。我按實際項目里最常用的形態(tài)還原一下核心結構public class SQLiteHelper { private readonly string _connStr; public SQLiteHelper(string dbPath, string password null) { // 拼接連接字符串密碼為空時不帶 Password 關鍵字 _connStr string.Format(Data Source{0};Version3;, dbPath); if (!string.IsNullOrEmpty(password)) _connStr Password password ;; } // 執(zhí)行增刪改返回受影響行數 public int ExecuteNonQuery(string sql, params SQLiteParameter[] ps) { using (var conn new SQLiteConnection(_connStr)) using (var cmd new SQLiteCommand(sql, conn)) { if (ps ! null ps.Length 0) cmd.Parameters.AddRange(ps); conn.Open(); return cmd.ExecuteNonQuery(); } } // 查詢返回 DataTable適合小數據量 public DataTable ExecuteQuery(string sql, params SQLiteParameter[] ps) { using (var conn new SQLiteConnection(_connStr)) using (var cmd new SQLiteCommand(sql, conn)) using (var adapter new SQLiteDataAdapter(cmd)) { if (ps ! null ps.Length 0) cmd.Parameters.AddRange(ps); var dt new DataTable(); adapter.Fill(dt); return dt; } } }邏輯說明構造函數負責拼連接串密碼可選ExecuteNonQuery用于 INSERT/UPDATE/DELETE用using保證連接釋放ExecuteQuery用SQLiteDataAdapter填充DataTable適合工控里幾百到幾千行的配置表。參數說明params SQLiteParameter[]是可變參數調用時可以傳零個或多個參數對象避免字符串拼接 SQL 帶來的注入風險。調用示例var helper new SQLiteHelper(D:\app\data\history.db, MyPass123); // 建表 helper.ExecuteNonQuery(CREATE TABLE IF NOT EXISTS Alarm(Id INTEGER PRIMARY KEY, Msg TEXT, Ts DATETIME)); // 插入用參數占位 helper.ExecuteNonQuery(INSERT INTO Alarm(Msg, Ts) VALUES(msg, ts), new SQLiteParameter(msg, 溫度超限), new SQLiteParameter(ts, DateTime.Now));3.2 給已有數據庫設置密碼ChangePassword 的用法這是這套源碼的重點。SQLite 加密不是「打開一個開關」而是對數據庫文件重新加密。System.Data.SQLite提供了SQLiteConnection.ChangePassword方法可以在連接打開后修改密碼。流程是先用舊密碼或空密碼連上再調ChangePassword設新密碼。public static void SetDatabasePassword(string dbPath, string oldPwd, string newPwd) { // 舊密碼為空時連接串不帶 Password string connStr string.Format(Data Source{0};Version3;, dbPath); if (!string.IsNullOrEmpty(oldPwd)) connStr Password oldPwd ;; using (var conn new SQLiteConnection(connStr)) { conn.Open(); // 關鍵在已打開的連接上改密碼 conn.ChangePassword(newPwd); conn.Close(); } }邏輯說明ChangePassword必須在連接打開狀態(tài)下調用它內部會重寫數據庫頁并更新文件頭。參數說明oldPwd是當前密碼沒設過就傳null或空串newPwd是目標密碼傳空串表示取消加密。注意這個方法執(zhí)行時間跟庫大小相關十萬條記錄的庫可能要幾秒別放在 UI 線程里否則界面會卡成「未響應」。調用// 給一個沒加密的庫設密碼 SetDatabasePassword(D:\app\data\history.db, null, MyPass123); // 改密碼 SetDatabasePassword(D:\app\data\history.db, MyPass123, NewPass456); // 取消密碼 SetDatabasePassword(D:\app\data\history.db, NewPass456, );3.3 建庫時就帶密碼新建加密庫的寫法如果庫還沒建可以直接在連接串里帶Password第一次Open時 SQLite 會按加密格式創(chuàng)建文件string connStr Data SourceD:\app\data\new.db;Version3;PasswordInitPwd;; using (var conn new SQLiteConnection(connStr)) { conn.Open(); using (var cmd new SQLiteCommand(CREATE TABLE Config(K TEXT, V TEXT), conn)) cmd.ExecuteNonQuery(); }這樣建出來的new.db從第一頁起就是加密的之后必須用InitPwd才能打開。參數說明Password長度沒有硬性限制但工控現場我一般建議 8 到 16 位太短容易被猜太長現場人員記不住會來煩你。字符集上避免用中文和特殊符號老版本 SQLite 對非 ASCII 口令的處理在不同平臺上有差異純字母數字最穩(wěn)。注意加密后的庫不能用普通 SQLite 工具直接打開包括 DB Browser for SQLite。要查看內容得用帶加密支持的連接方式或者先用代碼把密碼去掉再導出。4. 避坑與排查64 位 SQLite 在 VS2012 下最容易翻車的五件事4.1 現象運行報 BadImageFormatException 或找不到 SQLite.Interop.dll原因進程位數和 interop 位數不匹配或者x64子目錄沒被復制到輸出目錄。AnyCPU 在 64 位系統(tǒng)上跑成 64 位進程卻加載了 32 位 interop就會報這個。解決項目目標平臺明確設為x64確認bin\x64\Debug\x64\SQLite.Interop.dll存在如果用了安裝部署項目把x64文件夾一并打包進去。別偷懶只復制System.Data.SQLite.dll。4.2 現象帶密碼連接報「file is encrypted or is not a database」原因對一個沒加密的庫傳了Password或者密碼輸錯。SQLite 加密后文件頭被改寫密碼不對時它無法識別文件格式就報這個含糊的錯誤。解決先確認這個庫到底有沒有加密。判斷方法是用不帶Password的連接串去連如果能連上說明沒加密那就別傳密碼如果連不上再試密碼。密碼錯了沒有更精確的提示這是 SQLite 加密的固有行為只能靠你自己記牢。4.3 現象ChangePassword 執(zhí)行后程序卡死或超時原因ChangePassword會重寫整個數據庫文件數據量大時耗時明顯放在 UI 線程就卡界面如果此時還有別的連接開著可能觸發(fā)文件鎖。解決改密碼前確保沒有其他連接在操作這個庫把ChangePassword放到后臺線程執(zhí)行UI 上給個進度提示大庫改密碼前先備份一份萬一中途斷電文件可能損壞。4.4 現象32 位機器上部署后打不開庫原因開發(fā)機是 64 位編譯成 x64客戶現場是 32 位 Win7進程根本起不來或加載 interop 失敗。解決如果必須兼容 32 位就編譯兩個版本或者改回 AnyCPU 并同時帶上x86和x64兩個 interop 目錄讓運行時自己選。但 AnyCPU 有風險我一般直接問清楚現場系統(tǒng)位數編譯對應版本省得運行期出玄學問題。4.5 現象數據庫文件被現場人員用工具打開改了數據原因沒設密碼或者密碼在配置文件里明文寫著被翻出來了。解決給庫設密碼只是第一層連接串里的密碼別硬編碼在代碼里至少做個簡單混淆或放注冊表更徹底的做法是業(yè)務層加校驗字段比如關鍵記錄帶 HMAC被改了能發(fā)現。SQLite 加密防的是「隨手打開看看」防不住有心人這點要有預期。5. 進階把加密庫和明文導出打通以及一個我常用的驗證習慣實際維護中經常遇到一個尷尬庫加密了但要做數據遷移、報表導出又需要明文。這時候不能直接拿加密庫去喂第三方工具得先用代碼解密導出。思路是用帶密碼的連接讀數據寫到另一個不帶密碼的庫里。核心代碼如下public static void ExportToPlain(string srcPath, string pwd, string dstPath) { string srcConn string.Format(Data Source{0};Version3;Password{1};, srcPath, pwd); string dstConn string.Format(Data Source{0};Version3;, dstPath); using (var src new SQLiteConnection(srcConn)) using (var dst new SQLiteConnection(dstConn)) { src.Open(); dst.Open(); // 用 ATTACH 把目標庫掛到源連接上直接跨庫復制 using (var cmd new SQLiteCommand( string.Format(ATTACH DATABASE {0} AS plain KEY ;, dstPath), src)) { cmd.ExecuteNonQuery(); } // 復制表結構和數據 using (var cmd new SQLiteCommand( CREATE TABLE plain.Alarm AS SELECT * FROM main.Alarm;, src)) { cmd.ExecuteNonQuery(); } } }邏輯說明ATTACH DATABASE ... AS plain KEY 把目標庫以空密碼掛載CREATE TABLE plain.Alarm AS SELECT * FROM main.Alarm完成跨庫復制。參數說明KEY 表示目標庫不加密如果目標庫也要密碼把空串換成目標密碼即可。這個方法比逐行讀出來再插進去快得多十萬條記錄基本秒級。驗證方法上我有一個習慣每次改完密碼或做完導出一定用兩件事交叉驗證——一是用代碼帶密碼連一次能查到數據二是用不帶密碼的連接去連加密庫確認它確實連不上。兩個方向都對才說明加密狀態(tài)符合預期。只測一個方向很容易出現「以為加密了其實沒有」或者「以為沒加密其實設上了」的烏龍。還有個細節(jié)System.Data.SQLite的加密實現和 SQLCipher 不是一回事兩者生成的加密文件互不兼容。如果你的庫以后可能要用 SQLCipher 生態(tài)的工具打開一開始就得選 SQLCipher 方案別用這套ChangePassword。反過來如果只是自己項目內部用這套足夠依賴也簡單。從那以后我每次給老項目加 SQLite 加密都強制走一遍「設密碼 → 帶密碼讀 → 不帶密碼讀失敗 → 導出明文 → 再設回去」的完整回路確認每一步行為都符合預期才交付。希望幫到你。本文還有配套的精品資源點擊獲取