LiteDB是一个轻量级的嵌入式NoSQL数据库，专为.NET平台设计。它提供了简洁的API来存储和查询文档，非常适合桌面应用、移动应用或小型Web应用。LiteDB不需要额外的服务器或安装过程，只需一个简单的DLL引用，即可在你的C#项目中使用。
本文将介绍LiteDB的基础用法，并通过示例代码来展示如何在C#项目中集成和使用LiteDB。
1. 安装LiteDB
首先，你需要在你的项目中安装LiteDB。你可以通过NuGet包管理器来安装它。在Visual Studio中，右键点击你的项目 -> 选择“管理NuGet程序包” -> 搜索“LiteDB” -> 点击“安装”。
2. 创建或打开数据库
在使用LiteDB之前，你需要创建一个数据库连接。LiteDB使用文件来存储数据，因此你需要指定一个文件名来创建或打开一个数据库。
using LiteDB;
class Program
{
static void Main(string[] args)
{
using (var db = new LiteDatabase("filename=mydatabase.db"))
{
// 在这里操作数据库
}
}
}
在上面的代码中，我们创建了一个名为mydatabase.db
的LiteDB数据库。using
语句确保在操作完成后正确关闭数据库连接。
3. 定义数据模型
在LiteDB中，数据以文档的形式存储。每个文档都是一个BSON对象，可以包含任意数量和类型的字段。你可以定义一个C#类来表示你的数据模型。
public class Customer
{
public ObjectId Id { get; set; }
public string Name { get; set; }
public int Age { get; set; }
public string Email { get; set; }
}
在这个例子中，我们定义了一个名为Customer
的类，它包含了一个ObjectId类型的Id字段、一个字符串类型的Name字段、一个整数类型的Age字段和一个字符串类型的Email字段。
4. 插入数据
要向LiteDB插入数据，你需要获取一个集合（collection），然后调用其Insert方法。集合类似于SQL数据库中的表。
using (var db = new LiteDatabase("filename=mydatabase.db"))
{
var customers = db.GetCollection<Customer>("customers");
var customer = new Customer
{
Name = "John Doe",
Age = 30,
Email = "john.doe@example.com"
};
customers.Insert(customer);
}
在上面的代码中，我们首先获取了一个名为“customers”的集合，然后创建了一个新的Customer对象，并将其插入到集合中。LiteDB会自动为插入的文档生成一个ObjectId。
5. 查询数据
LiteDB提供了丰富的查询功能，允许你使用类似LINQ的语法来检索数据。
using (var db = new LiteDatabase("filename=mydatabase.db"))
{
var customers = db.GetCollection<Customer>("customers");
var query = customers.Find(c => c.Age > 25);
foreach (var customer in query)
{
Console.WriteLine($"Name: {customer.Name}, Age: {customer.Age}, Email: {customer.Email}");
}
}
在上面的代码中，我们执行了一个简单的查询，检索年龄大于25岁的所有客户。然后，我们遍历查询结果并打印出每个客户的姓名、年龄和电子邮件地址。
6. 更新和删除数据
LiteDB也支持更新和删除数据。你可以使用Update和Delete方法来修改或删除文档。
using (var db = new LiteDatabase("filename=mydatabase.db"))
{
var customers = db.GetCollection<Customer>("customers");
// 更新数据
var customerToUpdate = customers.FindById(new ObjectId("your-object-id-here"));
if (customerToUpdate != null)
{
customerToUpdate.Age = 31; // 更新年龄为31岁
customers.Update(customerToUpdate); // 更新数据库中的记录
}
// 删除数据
var customerToDelete = customers.FindById(new ObjectId("your-object-id-here"));
if (customerToDelete != null)
{
customers.Delete(customerToDelete); // 从数据库中删除记录
}
}
在上面的代码中，我们首先通过ObjectId查找要更新或删除的客户。然后，我们修改客户的年龄并调用Update方法来更新数据库中的记录。类似地，我们可以调用Delete方法来删除指定的记录。
结论
LiteDB是一个轻量级、易于使用的嵌入式NoSQL数据库，非常适合在C#项目中使用。它提供了简洁的API来存储、查询、更新和删除文档。通过本文中的示例代码，你应该已经了解了LiteDB的基础用法。现在，你可以开始在你的项目中使用LiteDB来存储和检索数据了。
