前言

在開發桌面應用程序時，數據庫是存儲和管理數據的核心組件。對于中小型項目或本地應用，SQLite 是一個非常理想的選擇。它輕量、無需安裝服務器、部署簡單，并且與 WinForm 配合良好。

本文將一步步了解如何在 WinForm 項目中集成 SQLite 數據庫，并結合 SqlSugar ORM 框架 實現高效的數據操作，包括連接數據庫、建表、插入、查詢等核心功能。

#WinForm開發技巧

#SQLite數據庫

一、SQLite 簡介

SQLite 是一種嵌入式的輕量級關系型數據庫系統，適用于資源有限的環境，如桌面應用、移動應用和小型 Web 應用。

? SQLite 的主要特點：

二、SQLite 下載與安裝（Windows 平臺）

1、打開 SQLite 官網；

2、根據系統選擇合適的版本下載（推薦 sqlite-tools-win32-x86-*.zip）；

3、解壓壓縮包后，你會看到如下幾個可執行文件：

sqlite3.exe：命令行工具

4、將解壓目錄添加到系統環境變量 PATH 中；

5、打開命令提示符輸入 sqlite3，若出現如下內容表示安裝成功。

三、創建 SQLite 數據庫（使用 Navicat）

Navicat 是一款強大的數據庫管理工具，支持 SQLite、MySQL、PostgreSQL 等多種數據庫。

步驟如下

1、打開 Navicat，點擊【新建連接】 → 【SQLite】；

2、輸入連接名，選擇"新建 SQLite 數據庫"；

3、設置數據庫保存路徑（建議放在項目目錄下，便于維護）；

4、創建完成后，會在指定路徑生成 .db 文件，即為 SQLite 數據庫文件。

四、在 WinForm 項目中使用 SqlSugar 操作 SQLite

1、安裝 SqlSugar

打開 Visual Studio，進入 NuGet 包管理器，搜索并安裝以下包（根據 .NET 版本選擇）：

如果是 .NET Core 或 .NET 5/6/7/8，安裝 SqlSugarCore

如果是 .NET Framework，則安裝 SqlSugar

2、配置數據庫連接字符串

// 獲取當前程序啟動路徑 + 數據庫文件名
public static string SQLitePath = Application.StartupPath + "\\demo.db";
public static string ConnectionString = "Data Source=" + SQLitePath;

// 初始化 SqlSugarClient
var db = new SqlSugarClient(new ConnectionConfig()
{
    DbType = DbType.Sqlite,
    ConnectionString = ConnectionString,
    IsAutoCloseConnection = true
});

?? 注意：Application.StartupPath 和 Environment.CurrentDirectory 通常指向項目編譯后的 bin\Debug 或 bin\Release 目錄。

3、創建實體類

在項目中創建一個 Student 類，用于映射數據庫表：

public class Student
{
    [SugarColumn(IsPrimaryKey = true, IsIdentity = true)]
    public int Id { get; set; }

    public string? Name { get; set; }
}

4、使用 Navicat 在 SQLite 中建表

在 Navicat 中手動創建一張名為 Student 的表，字段包括：

• Id（主鍵、自增）

• Name（文本類型）

5、編寫 WinForm 窗體代碼測試插入數據

在窗體中添加一個按鈕，并編寫如下事件處理邏輯：

private void button1_Click(object sender, EventArgs e)
{
    var student = new Student();
    student.Name = "小明";

    db.Insertable(student).ExecuteCommand(); // 插入數據
}

運行程序后，在 Navicat 中查看數據庫，確認數據已成功寫入。

五、總結

本文詳細介紹了如何在 WinForm 項目中使用 SQLite 數據庫，并結合 SqlSugar ORM 實現了數據庫連接、表結構定義、數據插入等基礎操作。SQLite 的輕量化和易用性使其成為中小型 WinForm 應用的理想選擇。

優勢

部署簡單，無需安裝數據庫服務器；

單文件存儲，易于備份和遷移；

結合 SqlSugar 可快速實現數據操作；

適合桌面應用、嵌入式系統、原型開發等場景。