C# 程序中使用 SQLite 数据库

2010-05-06 — Unmi

差不多在 3 年前我就关注过 SQLite，也整理了一篇 SQLite 的介绍：开源嵌入式数据库 SQLite 简介, 还在我的一个查手机归属地软件中使用了 SQLite 数据库，http://www.blogjava.net/Unmi/archive/2007/12/15/126225.html。

现在又要用到 C# 了，所以决意了解下 C# 中如何使用 SQLite，之所以选择 SQLite 作为自己的文件型数据，主要是看中它的非常小型、单文件、嵌入型，更支持多进程访问。

SQLite 官方网站：http://www.sqlite.org，你可以在那里下载到一个 sqlite3.exe，用命令行模式来管理你的数据库文件。或用其他比较好的管理工具：sqliteman(也支持 UTF-8) 、sqlitebrowser 和 SQLite Administrator。我比较喜欢 sqlitebrowser，但更推荐可设置字符集的 SQLite Expert(可下载到免费的个人版)。

既然是嵌入式数据库，只要些动态库就行，如 dll 原生库，jar 包或其他语言的组件库形式，.NET 中也不例如，要用到 System.Data.SQLite，下载安装后在安装目录中你有你所需的各种文件，使用 SQLite 只要在你的 .NET 应用引入 System.Data.SQLite.dll，如果要支持 LINQ，还要引入 System.Data.SQLite.Linq.dll。它支持到 ADO.NET 3.5，被 NHibernate 支持，并能集成在 VS2005/2008，且提供 64 位版，WinCE 版的动态库。SQLite.NET 也带了个帮助文档。

下面来直接看个例子，基本是借用了 C#使用SQLite数据库(asp.net/winform) 中的例子。

using System; 
using System.Data; 
using System.Data.SQLite; 
  
//C# 使用 SQLite 数据测试程序 
public class Program 
{ 
    public static void Main(string[] args) 
    { 
        using (SQLiteConnection con = new SQLiteConnection("Data Source=c:\\test.db3;Pooling=true;FailIfMissing=false")) 
        { 
            //打开数据库文件 c:\\test.db3，不存在则创建 
            con.Open(); 
  
            using (SQLiteCommand cmd = new SQLiteCommand()) 
            { 
                cmd.Connection = con; 
  
                //检查是否存在表 test，不存在则创建 
                Boolean testTableExists = false; 
                cmd.CommandText = "SELECT * FROM sqlite_master WHERE type='table' and name='test'"; 
                using(SQLiteDataReader dr = cmd.ExecuteReader()) 
                { 
                    if (dr.Read()) 
                    { 
                        testTableExists = true; 
                    } 
                } 
                if (!testTableExists) 
                { 
                    cmd.CommandText = "CREATE TABLE [test] (id int, name nvarchar(20))"; 
                    cmd.ExecuteNonQuery(); 
                } 
  
                //清空 test 表 
                cmd.CommandText = "DELETE FROM [test]"; 
                cmd.ExecuteNonQuery(); 
  
                //插入测试数据 
                for (int i = 1; i <= 5; i++) 
                { 
                    cmd.CommandText = string.Format("INSERT INTO [test] VALUES ({0}, '中文测试')", i); 
                    cmd.ExecuteNonQuery(); 
                } 
  
                //读取数据 
                cmd.CommandText = "SELECT * FROM [test]"; 
                using (SQLiteDataReader dr = cmd.ExecuteReader(CommandBehavior.CloseConnection)) 
                { 
                    while (dr.Read()) 
                    { 
                        Console.WriteLine("第{0} 条：{1}", dr.GetValue(0), dr.GetString(1)); 
                    } 
                } 
            } 
        } 
  
        Console.WriteLine("Press any key to continue..."); 
        Console.ReadKey(); 
    } 
}

运行之后，你会发现，中文可以插入，并且显示出来也没问题，但是用一般的 SQLite 管理工具看到的却是乱码。同样，在其他客户端中输入的中文让上面程序读出来也是乱码。幸运的是还是找到一种客户端工具 SQLite Expert(可下载到免费的个人版), 看到的结果是中文，这是因为 System.Data.SQLite 默认使用的是 UTF-8 字符集，而 SQLite Expert 有字符集的选择可设置的。其他的客户端默认的字符集都是 ANSI，也就是 ISO8859-1 吧。

其他相关内容：连接字符串的参数配置：

在安装后的 SQLite.NET Help 帮助文档中可以查到详细的连接参数说明. 查 ConnectionString Property，或看链接：Connection String:

Parameter	Values	Required	Default
Version	3	N	3
Data Source	{filename}	Y
Version	3	N	3
UseUTF16Encoding	True False	N	False
DateTimeFormat	Ticks - Use DateTime.Ticks ISO8601 - Use ISO8601 DateTime format	N	ISO8601
BinaryGUID	Yes/On/1 - Store GUID columns in binary form No/Off/0 - Store GUID columns as text	N	On
Cache Size	{size in bytes}	N	2000
Synchronous	Normal - Normal file flushing behavior Full - Full flushing after all writes Off - Underlying OS flushes I/O's	N	Normal
Page Size	{size in bytes}	N	1024
Password	{password}	N
Enlist	Y - Automatically enlist in distributed transactions N - No automatic enlistment	N	Y
Pooling	True - Use connection pooling False - Do not use connection pooling	N	False
FailIfMissing	True - Don't create the database if it does not exist, throw an error instead False - Automatically create the database if it does not exist	N	False
Max Page Count	{size in pages} - Limits the maximum number of pages (limits the size) of the database	N	0
Legacy Format	True - Use the more compatible legacy 3.x database format False - Use the newer 3.3x database format which compresses numbers more effectively

留意其中几个参数，或许对你有用。比如 System.Data.SQLite 单方面支持密码保护，但其他的 SQLite 客户端无法读取这样的文件。