SQLite Helper (C#) zt

http://www.codeproject.com/Articles/746191/SQLite-Helper-Csharp

This small class (SQLiteHelper.cs) is built on top of System.Data.SQLite.DLL. A reference of this DLL must be added into your projects.

Download: https://system.data.sqlite.org

List of Simplified Functions

1. GetTableStatus
2. GetTableList
3. GetColumnStatus
4. CreateTable
5. UpdateTableStructure
6. BeginTransaction, Commit, Rollback
7. Select
8. Execute
9. ExecuteScalar
10. Escape
11. Insert
12. Update
13. LastInsertRowId
14. RenameTable
15. CopyAllData
16. DropTable
17. ShowDatabase
18. AttachDatabase, DetachDatabase

Getting Start

Add this using statement at the top of your class:

using System.Data.SQLite;

SQLiteConnection and SQLiteCommand have to be initialized before using SQLiteHelper:

Example:

using (SQLiteConnection conn = new SQLiteConnection("data source=C:\\data"))
{
    using (SQLiteCommand cmd = new SQLiteCommand())
    {
        cmd.Connection = conn;
        conn.Open();
 
        SQLiteHelper sh = new SQLiteHelper(cmd);
 
        // do something...

        conn.Close();
    }
}

1. GetTableStatus

Get all information of tables in the database.

DataTable dt = sh.GetTableStatus();

Sample result:

2. GetTableList

Get a list of tables in database.

DataTable dt = sh.GetTableList();

3. GetColumnStatus

Get all information of columns in specific table.

// Get column‘s information from table "person"
DataTable dt = sh.GetColumnStatus("person");

Sample Result:

4. CreateTable

Create table.

Example table structure: Person

SQLiteTable tb = new SQLiteTable("person");
 
tb.Columns.Add(new SQLiteColumn("id", true));
tb.Columns.Add(new SQLiteColumn("name"));
tb.Columns.Add(new SQLiteColumn("membershipid", ColType.Integer));
tb.Columns.Add(new SQLiteColumn("level", ColType.Decimal, false, false, "5.5"));
 
sh.CreateTable(tb);

5. UpdateTableStructure

As the name said, it is used to update a table‘s structure. Maybe you have added new columns, or drop/deleted some columns. This method helps you to update it.

The process at code behind:

• Assume that the old table is named: person
• The class creates a temporary table (named: person_temp) with your new defined structure.
• Copy all rows from person to person_temp.
• Drop/delete table of person.
• Rename table of person_temp to person

Code example:

SQLiteTable tb = new SQLiteTable();
tb.Columns.Add(new SQLiteColumn("id", true));
tb.Columns.Add(new SQLiteColumn("name"));
tb.Columns.Add(new SQLiteColumn("sku"));
tb.Columns.Add(new SQLiteColumn("code"));
tb.Columns.Add(new SQLiteColumn("category"));
tb.Columns.Add(new SQLiteColumn("remarks"));

sh.UpdateTableStructure("person", tb);

6. BeginTransaction, Commit, Rollback

What is transaction?

By default, every SQL query that is sent to SQLite database engine happens in a transaction. The engine automatically BEGIN a transaction and COMMIT it at the end. COMMIT is something like "Make it take effect".

If we send 3 SQL queries (INSERT, UPDATE, DELETE, etc...), 3 transactions are taken place. According to [SQLite official documentation - Frequently Asked Questions]:

Collapse | Copy Code

sh.BeginTransaction();
 
try
{
    // INSERT.....
    // INSERT.....
    // UPDATE....
    // ... skip for another 50,000 queries....
    // DELETE....
    // UPDATE...
    // INSERT.....

    sh.Commit();
}
catch
{
    sh.Rollback();
}

ROLLBACK, in the above example means Cancel Transaction. All queries that have sent to SQLite database within that specific transaction are dismissed.

7. Select

Return the query result in DataTable format.

• Select(string sql)
• Select(string sql, Dictionary<string, object> dicParameters = null)
• Select(string sql, IEnumerable<SQLiteParameter> parameters = null)

Example 1:

Collapse | Copy Code

DataTable dt = sh.Select("select * from person order by id;");

Example 2 (With parameters support):

Collapse | Copy Code

var dic = new Dictionarystring, object();
dic["@aaa"] = 1;
dic["@bbb"] = 1;
DataTable dt = sh.Select("select * from member where membershipid = @aaa and locationid = @bbb;", dic);

Example 3 (With parameters support):

Collapse | Copy Code

DataTable dt = sh.Select("select * from member where membershipid = @aaa and locationid = @bbb;",
    new SQLiteParameter[] { 
        new SQLiteParameter("@aaa", 1),
        new SQLiteParameter("@bbb", 1)
    });

8. Execute

Execute single SQL query.

• Execute(string sql)
• Execute(string sql, Dictionary<string, object> dicParameters = null)
• Execute(string sql, IEnumerable<SQLiteParameter> parameters = null)

Example:

Collapse | Copy Code

sh.Execute("insert into person(name)values(‘hello‘);");

9. ExecuteScalar

Return the result of first row first column in specific data type.

• ExecuteScalar(string sql)
• ExecuteScalar(string sql, Dictionary<string, object> dicParameters = null)
• ExecuteScalar(string sql, IEnumerable<SQLiteParameter> parameters = null)
• ExecuteScalar<datatype>(string sql)
• ExecuteScalar<datatype>(string sql, Dictionary<string, object> dicParameters = null)
• ExecuteScalar<datatype>(string sql, IEnumerable<SQLiteParameter> parameters = null)

Example:

Collapse | Copy Code

string a = sh.ExecuteScalar<string>("select ‘Hello!‘;");

int b = sh.ExecuteScalar<int>("select 1000;");

decimal c = sh.ExecuteScalar<decimal>("select 4.4;");

DateTime d = sh.ExecuteScalar<DateTime>("select date(‘now‘);");

byte[] e = sh.ExecuteScalar<byte[]>("select randomblob(16);");

10. Escape

Escape string sequence for text value to avoid SQL injection or invalid SQL syntax to be constructed.

Collapse | Copy Code

sh.Execute("insert into person(name) values(‘" + Escape(input) + "‘);");

11. Insert

Insert new row of data. All data will be added as parameters at code behind. This support blob (byte[]) value too.

Collapse | Copy Code

var dic = new Dictionary<string, object>();
dic["name"] = "John";
dic["membershipid"] = 1;
dic["level"] = 6.8;
 
sh.Insert("person", dic);

12. Update

Update row. All data will be added as parameters at code behind. This support blob (byte[]) value too.

Example 1: Update with single condition (where id = 1)

Collapse | Copy Code

var dicData = new Dictionary<string, object>();
dicData["name"] = "no name";
dicData["membershipid"] = 0;
dicData["level"] = 5.5;
 
sh.Update("person", dicData, "id", 1);

Example 2: Update with multiple condition (where membership = 1 and level = 5.5 and teamid = 1)

Collapse | Copy Code

var dicData = new Dictionary<string, object>();
dicData["name"] = "no name";
dicData["status"] = 0;
dicData["money"] = 100;
dicData["dateregister"] = DateTime.MinValue;
 
var dicCondition = new Dictionary<string, object>();
dicCondition["membershipid"] = 1;
dicCondition["level"] = 5.5;
dicCondition["teamid"] = 1;
 
sh.Update("person", dicData, dicCondition);

13. LastInsertRowId

Get the last issued id (Auto-Increment)

Collapse | Copy Code

sh.Insert("person", dicData);
long id = sh.LastInsertRowId();

14. RenameTable

Rename a table.

Collapse | Copy Code

sh.RenameTable("person", "person_backup");

15. CopyAllData

Copy all data from one table to another.

Collapse | Copy Code

sh.CopyAllData("person", "person_new");

Before copying, SQLiteHelper will scan the two tables for match columns. Only columns that exist in both tables will be copied.

16. DropTable

Drop table, delete a table

Collapse | Copy Code

sh.DropTable("person");

17. ShowDatabase

Display attached databases.

Collapse | Copy Code

DataTable dt = sh.ShowDatabase();

18. AttachDatabase, DetachDatabase

Attach or detach a database

Collapse | Copy Code

sh.AttachDatabase("C:\\data2013.sq3", "lastyeardb");
sb.DetachDatabase("lastyeardb");

That‘s it, guys/girls. Comments are welcome.

SQLite Helper (C#) zt,布布扣,bubuko.com