在C#中,将数据库查询结果映射到对象是数据访问中的常见需求。实现方式有多种,每种适用于不同的场景和开发偏好。以下是几种主流方法:
1. 使用 ADO.NET 手动映射
这是最基础的方式,通过 SqlConnection、SqlCommand 和 SqlDataReader 执行查询,然后逐行读取数据并手动赋值给对象属性。优点:完全控制,性能高;缺点:代码重复多,易出错。
示例:
public class User
{
public int Id { get; set; }
public string Name { get; set; }
public string Email { get; set; }
}
<p>using (var connection = new SqlConnection(connectionString))
{
connection.Open();
using (var command = new SqlCommand("SELECT Id, Name, Email FROM Users", connection))
using (var reader = command.ExecuteReader())
{
var users = new List<User>();
while (reader.Read())
{
users.Add(new User
{
Id = reader.GetInt32("Id"),
Name = reader.GetString("Name"),
Email = reader.GetString("Email")
});
}
return users;
}
}
</p>2. 使用 Entity Framework(EF)或 EF Core
Entity Framework 是微软官方的 ORM 框架,支持自动将查询结果映射到实体类。只需定义类与数据库表的对应关系(可通过数据注解或 Fluent API),EF 会自动生成 SQL 并完成映射。
示例:
public class AppDbContext : DbContext
{
public DbSet<User> Users { get; set; }
}
<p>// 查询自动映射
using (var context = new AppDbContext())
{
var users = context.Users.Where(u => u.Name.Contains("John")).ToList();
}
</p>支持 LINQ 查询,类型安全,开发效率高。适合中大型项目。
3. 使用 Dapper 微型 ORM
Dapper 是一个轻量级扩展库,为 IDbConnection 添加了快速的对象映射能力。它在性能上接近原生 ADO.NET,同时大幅简化映射代码。
示例:
using (var connection = new SqlConnection(connectionString))
{
var users = connection.Query<User>("SELECT * FROM Users WHERE Age > @Age", new { Age = 18 });
return users.ToList();
}
Dapper 支持复杂类型映射、多结果集、存储过程等,广泛用于高性能场景。
4. 使用 AutoMapper 配合数据读取器
AutoMapper 本身不直接执行查询,但可与 ADO.NET 或其他数据源结合,将 DataReader 或 DataTable 映射到对象集合。通常需要配合自定义映射逻辑或第三方扩展(如 AutoMapper.Data)使用。
示例思路:
using (var reader = command.ExecuteReader())
{
var config = new MapperConfiguration(cfg => cfg.CreateMap<IDataReader, User>());
var mapper = config.CreateMapper();
var users = mapper.Map<IEnumerable<User>>(reader);
}
适合已有大量 DTO 的项目,统一映射规则。
5. 自定义泛型映射工具
可通过反射编写通用映射方法,将 SqlDataReader 或 DataRow 自动填充到任意对象。例如创建一个 DataReaderMapper 类:
public static List<T> Map<T>(IDataReader reader) where T : new()
{
var list = new List<T>();
var type = typeof(T);
var properties = type.GetProperties().Where(p => p.CanWrite);
<pre class="brush:php;toolbar:false;">while (reader.Read())
{
var obj = new T();
foreach (var prop in properties)
{
if (!reader.IsDBNull(prop.Name))
{
var value = reader[prop.Name];
prop.SetValue(obj, Convert.ChangeType(value, prop.PropertyType));
}
}
list.Add(obj);
}
return list;}
灵活但需注意性能和异常处理。
基本上就这些常用方式。选择哪种取决于项目规模、性能要求和开发效率权衡。小型项目可用 Dapper,大型系统推荐 EF Core,极致性能可手写 ADO.NET。
