C# 程序中使用 SQLite 数据库
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) 中的例子。
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
|
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 客户端无法读取这样的文件。