# SQLite C# 简介

> 原文： [http://zetcode.com/db/sqlitecsharp/intro/](http://zetcode.com/db/sqlitecsharp/intro/)

在 SQLite C# 教程的第一章中，我们将提供必要的定义。 我们将展示如何安装 Mono。 本教程中的所有示例都将在 Mono 上运行。 稍后，我们创建第一个工作示例。

## 关于 SQLite 数据库

_SQLite_ 是嵌入式关系数据库引擎。 它的开发者称其为自包含，无服务器，零配置和事务型 SQL 数据库引擎。 它非常受欢迎，当今全球有数亿本使用。 SQLite 用于 Solaris 10 和 Mac OS 操作系统，iPhone 或 Skype。 Qt4 库对 SQLite 以及 Python 或 PHP 语言提供了内置支持。 许多流行的应用内部都使用 SQLite，例如 Firefox 或 Amarok。

```cs
$ sudo apt-get install sqlite3

```

如果尚未安装`sqlite3`库，则需要安装它。

SQLite 附带`sqlite3`命令行工具。 它可用于对数据库发出 SQL 命令。 现在，我们将使用`sqlite3`命令行工具创建一个新数据库。

```cs
$ sqlite3 test.db
SQLite version 3.6.22
Enter ".help" for instructions
Enter SQL statements terminated with a ";"

```

我们为`sqlite3`工具提供了一个参数。 `test.db`是数据库名称。 它是我们磁盘上的单个文件。 如果存在，则将其打开。 如果不是，则创建它。

```cs
sqlite> .tables
sqlite> .exit
$ ls
test.db

```

`.tables`命令提供了`test.db`数据库中的表列表。 当前没有表。 `.exit`命令终止`sqlite3`命令行工具的交互式会话。 `ls` Unix 命令显示当前工作目录的内容。 我们可以看到`test.db`文件。 所有数据将存储在该单个文件中。

## Mono

Mono 是基于 C# 和公共语言运行时的 ECMA 标准的 Microsoft .NET Framework 的开源实现。 在本教程中，我们需要安装 Mono 才能编译和运行示例。

可以从 Linux 发行版的包中安装 Mono，也可以从源代码中安装 Mono，以获得更多最新版本。

```cs
$ bunzip2 mono-2.10.8.tar.bz2
$ tar -xf mono-2.10.8.tar
$ cd mono-2.10.8/
$ ./configure
$ make
$ sudo make install

```

我们从 Mono 网站下载`mono-2.10.8.tar.bz2` tarball。 解压缩，构建并安装库。 我们安装了 Mono 运行时，C# 语言和 SQLite C# 数据适配器。

```cs
$ bunzip2 libgdiplus-2.10.9.tar.bz2 
$ tar -xf libgdiplus-2.10.9.tar 
$ cd libgdiplus-2.10.9/
$ ./configure
$ make
$ sudo make install

```

对于带有 Winforms 控件的示例，我们还需要`libgdiplus`库。 它位于单独的文件中。 我们构建并安装它。

```cs
$ sudo ldconfig
$ ldconfig -p | grep libgdiplus
        libgdiplus.so.0 (libc6) => /usr/local/lib/libgdiplus.so.0
        libgdiplus.so (libc6) => /usr/local/lib/libgdiplus.so

```

我们还运行`ldconfig`工具来更新动态库的数据库。 `ldconfig`扫描正在运行的系统，并设置用于加载共享库的符号链接。

`Mono.Data.Sqlite`程序集包含 SQLite 数据库的 ADO.NET 数据供应器。 它用 C# 编写，并且可用于所有 CLI 语言：C# ，Visual Basic，Boo 等。

```cs
$ ls /usr/local/lib/mono/4.0/Mono.Data.Sqlite.dll 
/usr/local/lib/mono/4.0/Mono.Data.Sqlite.dll

```

从技术角度来看，我们需要一个 DLL。 在我们的系统上，它位于上述路径下。 （实际上，以上是指向 DLL 的软链接，该 DLL 位于`gac`子目录中。）

## ADO.NET

`ADO.NET`是 .NET 框架的重要组成部分。 该规范统一了对关系数据库，XML 文件和其他应用数据的访问。 从程序员的角度来看，它是一组与数据库和其他数据源一起使用的库和类。 `Mono.Data.SQLite`是 SQLite 数据库的 ADO.NET 规范的实现。 它是用 C# 语言编写的驱动程序，可用于所有.NET 语言。

`SqliteConnection`，`SqliteCommand`，`SqliteDataReader`和`SqliteDataAdapter`是.NET 数据供应器模型的核心元素。 `SqliteConnection`创建到特定数据源的连接。 `SqliteCommand`对象针对数据源执行一条 SQL 语句。 `SqliteDataReader`从数据源读取数据流。 `SqliteDataAdapter`是`DataSet`和数据源之间的中介。 它填充`DataSet`并解析数据源的更新。

`DataSet`对象用于大量数据的离线工作。 它是一种断开连接的数据表示形式，可以保存来自各种不同来源的数据。 `SqliteDataReader`和`DataSet`都用于处理数据。 它们在不同的情况下使用。 如果只需要读取查询结果，则`SqliteDataReader`是更好的选择。 如果我们需要更广泛的数据处理，或者要将 Winforms 控件绑定到数据库表，则首选`DataSet`。

## SQLite 版本

如果是第一个程序，我们将检查 SQLite 数据库的版本。

```cs
using System;
using Mono.Data.Sqlite;

public class Example
{

    static void Main() 
    {
        string cs = "Data Source=:memory:";

        SqliteConnection con = null;
        SqliteCommand cmd = null;

        try 
        {
            con = new SqliteConnection(cs);
            con.Open();

            string stm = "SELECT SQLITE_VERSION()";   
            cmd = new SqliteCommand(stm, con);

            string version = Convert.ToString(cmd.ExecuteScalar());

            Console.WriteLine("SQLite version : {0}", version);

        } catch (SqliteException ex) 
        {
            Console.WriteLine("Error: {0}",  ex.ToString());

        } finally 
        {   
            if (cmd != null)
            {
                cmd.Dispose();
            }

            if (con != null) 
            {
                try 
                {
                    con.Close();

                } catch (SqliteException ex)
                { 
                    Console.WriteLine("Closing connection failed.");
                    Console.WriteLine("Error: {0}",  ex.ToString());

                } finally 
                {
                    con.Dispose();
                }
            }                        
        }
    }
}

```

我们连接到内存数据库并选择一个 SQLite 版本。

```cs
using Mono.Data.Sqlite;

```

`Mono.Data.SqliteClient`程序集包含 SQLite 数据库引擎的 ADO.NET 数据供应器。 我们导入 SQLite 数据供应器的元素。

```cs
string cs = "Data Source=:memory:";

```

这是连接字符串。 数据提供者使用它来建立与数据库的连接。 我们创建一个内存数据库。

```cs
con = new SqliteConnection(cs);

```

创建一个`SqliteConnection`对象。 该对象用于打开与数据库的连接。

```cs
con.Open();

```

这行打开数据库连接。

```cs
string stm = "SELECT SQLITE_VERSION()";   

```

这是`SQL SELECT`语句。 它返回数据库的版本。 `SQLITE_VERSION()`是内置的 SQLite 函数。

```cs
SqliteCommand cmd = new SqliteCommand(stm, con);

```

`SqliteCommand`是一个对象，用于在数据库上执行查询。 参数是 SQL 语句和连接对象。

```cs
string version = Convert.ToString(cmd.ExecuteScalar());

```

有些查询仅返回标量值。 在我们的例子中，我们需要一个简单的字符串来指定数据库的版本。 在这种情况下使用`ExecuteScalar()`。 我们避免了使用更复杂的对象的开销。

```cs
Console.WriteLine("SQLite version : {0}", version);

```

数据库的版本将打印到控制台。

```cs
} catch (SqliteException ex) 
{
    Console.WriteLine("Error: {0}",  ex.ToString());

```

如果发生异常，我们将错误消息打印到控制台。

```cs
} finally 
{   
    if (cmd != null)
    {
        cmd.Dispose();
    }

```

`SqliteCommand`类实现`IDisposable`接口。 因此，必须对其进行明确处理。

```cs
if (con != null) 
{
    try 
    {
        con.Close();

    } catch (SqliteException ex)
    { 
        Console.WriteLine("Closing connection failed.");
        Console.WriteLine("Error: {0}",  ex.ToString());

    } finally 
    {
        con.Dispose();
    }
}  

```

关闭连接可能会引发另一个异常。 我们处理这种情况。

```cs
$ dmcs version.cs -r:Mono.Data.Sqlite.dll

```

我们汇编示例。 提供了 SQLite 数据供应器 DLL 的路径。

```cs
$ mono ./version.exe 
SQLite version : 3.7.7

```

这是我们系统上程序的输出。

## `using`语句

C# 语言实现垃圾回收。 这是一个自动释放不再需要的对象的过程。 该过程是不确定的。 我们不能确定 CLR（公共语言运行时）何时决定释放资源。 对于有限的资源，例如文件句柄或网络连接，最好尽快释放它们。 使用`using`语句，程序员可以控制何时释放资源。 当程序超出了`using`块时，到达其末尾或引发异常，则资源被释放。

在内部，`using`语句被转换为`try`，`finally`块，在`finally`块中调用了`Dispose()`。 请注意，您可能更喜欢使用`try`，`catch`和`finally`块，而不是`using`语句。 特别是，如果您想显式地利用`catch`块。 在本教程中，我们选择了 using 语句。 主要是因为代码较短。

通常，当我们使用`IDisposable`对象时，应在`using`语句中声明并实例化它。 （或在`finally`块中调用`Dispose()`方法。）对于 SQLite ADO.NET 驱动程序，我们对`SqliteConnection`，`SqliteCommand`，`SqliteDataReader`，`SqliteCommandBuilder`和`SqliteDataAdapter`类使用`using`语句。 我们不必将其用于`DataSet`或`DataTable`类。 他们可以留给垃圾收集器。

```cs
using System;
using Mono.Data.Sqlite;

public class Example
{

    static void Main() 
    {
        string cs = "URI=file:test.db";

        using (SqliteConnection con = new SqliteConnection(cs)) 
        {
            con.Open();

            using (SqliteCommand cmd = new SqliteCommand(con))
            {
                cmd.CommandText = "SELECT SQLITE_VERSION()";
                string version = Convert.ToString(cmd.ExecuteScalar());

                Console.WriteLine("SQLite version : {0}", version);
            }             

            con.Close();
        }
    }
}

```

我们有同样的例子。 这次我们实现了`using`关键字。

```cs
using (SqliteConnection con = new SqliteConnection(cs)) 
{
    con.Open();

    using (SqliteCommand cmd = new SqliteCommand(con))

```

`SqliteConnection`和`SqliteCommand`都实现`IDisposable`接口。 因此，它们用`using`关键字包装。

## 创建并填充表

接下来，我们将创建一个数据库表并用数据填充它。

```cs
using System;
using Mono.Data.Sqlite;

public class Example
{

    static void Main() 
    {

        string cs = "URI=file:test.db";

        using ( SqliteConnection con = new SqliteConnection(cs))
        {
            con.Open();

            using (SqliteCommand cmd = new SqliteCommand(con))
            {
                cmd.CommandText = "DROP TABLE IF EXISTS Cars";
                cmd.ExecuteNonQuery();
                cmd.CommandText = @"CREATE TABLE Cars(Id INTEGER PRIMARY KEY, 
                    Name TEXT, Price INT)";
                cmd.ExecuteNonQuery();
                cmd.CommandText = "INSERT INTO Cars VALUES(1,'Audi',52642)";
                cmd.ExecuteNonQuery();
                cmd.CommandText = "INSERT INTO Cars VALUES(2,'Mercedes',57127)";
                cmd.ExecuteNonQuery();
                cmd.CommandText = "INSERT INTO Cars VALUES(3,'Skoda',9000)";
                cmd.ExecuteNonQuery();
                cmd.CommandText = "INSERT INTO Cars VALUES(4,'Volvo',29000)";
                cmd.ExecuteNonQuery();
                cmd.CommandText = "INSERT INTO Cars VALUES(5,'Bentley',350000)";
                cmd.ExecuteNonQuery();
                cmd.CommandText = "INSERT INTO Cars VALUES(6,'Citroen',21000)";
                cmd.ExecuteNonQuery();
                cmd.CommandText = "INSERT INTO Cars VALUES(7,'Hummer',41400)";
                cmd.ExecuteNonQuery();
                cmd.CommandText = "INSERT INTO Cars VALUES(8,'Volkswagen',21600)";
                cmd.ExecuteNonQuery();
            }             

            con.Close();
        }
    }
}

```

在上面的代码示例中，我们创建具有 8 行的`Cars`表。

```cs
cmd.CommandText = "DROP TABLE IF EXISTS Cars";
cmd.ExecuteNonQuery();

```

首先，如果该表已经存在，则将其删除。 如果我们不想要结果集，例如对于`DROP`，`INSERT`或`DELETE`语句，可以使用`ExecuteNonQuery()`方法。

```cs
cmd.CommandText = @"CREATE TABLE Cars(Id INTEGER PRIMARY KEY, 
    Name TEXT, Price INT)";
cmd.ExecuteNonQuery();

```

`Cars`表已创建。 `INTEGER PRIMARY KEY`列在 SQLite 中自动增加。

```cs
cmd.CommandText = "INSERT INTO Cars VALUES(1,'Audi',52642)";
cmd.ExecuteNonQuery();
cmd.CommandText = "INSERT INTO Cars VALUES(2,'Mercedes',57127)";
cmd.ExecuteNonQuery();

```

我们在表中插入两行。

```cs
sqlite> .mode column  
sqlite> .headers on

```

在`sqlite3`命令行工具中，我们修改了数据在控制台中的显示方式。 我们使用列模式并打开标题。

```cs
sqlite> SELECT * FROM Cars;
Id          Name        Price     
----------  ----------  ----------
1           Audi        52642     
2           Mercedes    57127     
3           Skoda       9000      
4           Volvo       29000     
5           Bentley     350000    
6           Citroen     21000     
7           Hummer      41400     
8           Volkswagen  21600     

```

我们验证数据。 `Cars`表已成功创建。

## 预备语句

现在，我们将以预备语句来关注自己。 在编写预备语句时，我们使用占位符，而不是直接将值写入语句中。 预准备的语句可提高安全性和性能。

```cs
using System;
using Mono.Data.Sqlite;

public class Example
{

    static void Main() 
    {

        string cs = "URI=file:test.db";

        using(SqliteConnection con = new SqliteConnection(cs))
        {
            con.Open();

            using (SqliteCommand cmd = new SqliteCommand(con)) 
            {
                cmd.CommandText = "INSERT INTO Cars(Name, Price) VALUES(@Name, @Price)";
                cmd.Prepare();

                cmd.Parameters.AddWithValue("@Name", "BMW");
                cmd.Parameters.AddWithValue("@Price", 36600);
                cmd.ExecuteNonQuery();
            }

            con.Close();
        }
    }
}

```

我们向`Cars`表添加一行。 我们使用参数化命令。

```cs
cmd.CommandText = "INSERT INTO Cars(Name, Price) VALUES(@Name, @Price)";
cmd.Prepare();

```

在这里，我们创建一个预备语句。 在编写预备语句时，我们使用占位符，而不是直接将值写入语句中。 预备语句更快，并且可以防止 SQL 注入攻击。 `@Name`和`@Price`是占位符，稍后将填充。

```cs
cmd.Parameters.AddWithValue("@Name", "BMW");
cmd.Parameters.AddWithValue("@Price", 36600);

```

值绑定到占位符。

```cs
cmd.ExecuteNonQuery();

```

执行预备语句。 当我们不希望返回任何数据时，我们使用`SqliteCommand`对象的`ExecuteNonQuery()`方法。

```cs
$ mono prepared.exe 

sqlite> SELECT * FROM Cars;
Id          Name        Price     
----------  ----------  ----------
1           Audi        52642     
2           Mercedes    57127     
3           Skoda       9000      
4           Volvo       29000     
5           Bentley     350000    
6           Citroen     21000     
7           Hummer      41400     
8           Volkswagen  21600     
9           BMW         36600  

```

我们有一辆新车插入表。

## 数据来源

已咨询 MSDN（Microsoft 开发者网络）来创建本教程。 该网站有几种定义。

这是 SQLite C# 教程的介绍性章节。