《.NET MVC 连接本地数据库三种方法总结》
在.NET MVC开发中，连接本地数据库是构建数据驱动型应用的基础。无论是SQL Server、SQLite还是MySQL等本地数据库，掌握多种连接方式不仅能提升开发效率，还能增强代码的灵活性和可维护性。本文将详细介绍三种常见的.NET MVC连接本地数据库的方法，包括Entity Framework Core（EF Core）、ADO.NET原生连接以及Dapper轻量级ORM，帮助开发者根据项目需求选择合适的方案。
一、方法一：使用Entity Framework Core（EF Core）
EF Core是微软官方推荐的ORM框架，它通过LINQ查询和强类型实体模型简化了数据库操作，支持迁移（Migration）和代码优先（Code-First）开发模式，尤其适合中大型项目。
1.1 安装必要的NuGet包
在.NET MVC项目中，首先需要安装EF Core的核心包和对应数据库提供程序。例如，连接SQL Server时需安装以下包：
Install-Package Microsoft.EntityFrameworkCore
Install-Package Microsoft.EntityFrameworkCore.SqlServer
1.2 创建DbContext和实体类
定义实体类（如`User`）和继承自`DbContext`的上下文类（如`AppDbContext`）：
public class User
{
public int Id { get; set; }
public string Name { get; set; }
public string Email { get; set; }
}
public class AppDbContext : DbContext
{
public DbSet Users { get; set; }
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
optionsBuilder.UseSqlServer("Server=(localdb)\\mssqllocaldb;Database=MyDb;Trusted_Connection=True;");
}
}
1.3 配置依赖注入（DI）
在`Startup.cs`中注册`DbContext`：
public void ConfigureServices(IServiceCollection services)
{
services.AddDbContext(options =>
options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection")));
services.AddControllersWithViews();
}
并在`appsettings.json`中配置连接字符串：
{
"ConnectionStrings": {
"DefaultConnection": "Server=(localdb)\\mssqllocaldb;Database=MyDb;Trusted_Connection=True;"
}
}
1.4 使用EF Core进行CRUD操作
在控制器中注入`AppDbContext`并操作数据：
public class UserController : Controller
{
private readonly AppDbContext _context;
public UserController(AppDbContext context)
{
_context = context;
}
public IActionResult Index()
{
var users = _context.Users.ToList();
return View(users);
}
[HttpPost]
public IActionResult Create(User user)
{
_context.Users.Add(user);
_context.SaveChanges();
return RedirectToAction("Index");
}
}
1.5 代码迁移与数据库更新
使用EF Core的迁移功能管理数据库结构变更：
Add-Migration InitialCreate
Update-Database
二、方法二：使用ADO.NET原生连接
ADO.NET是.NET Framework中直接操作数据库的底层API，适合需要精细控制SQL语句或性能要求极高的场景。虽然代码量较大，但灵活性高。
2.1 配置连接字符串
在`Web.config`或`appsettings.json`中定义连接字符串：
{
"ConnectionStrings": {
"LocalDb": "Data Source=(localdb)\\mssqllocaldb;Initial Catalog=MyDb;Integrated Security=True;"
}
}
2.2 创建数据库帮助类
封装一个`DbHelper`类来管理连接和命令：
public class DbHelper
{
private readonly string _connectionString;
public DbHelper(IConfiguration configuration)
{
_connectionString = configuration.GetConnectionString("LocalDb");
}
public SqlConnection GetConnection()
{
return new SqlConnection(_connectionString);
}
public DataTable ExecuteQuery(string sql, params SqlParameter[] parameters)
{
using (var connection = GetConnection())
{
using (var command = new SqlCommand(sql, connection))
{
command.Parameters.AddRange(parameters);
var adapter = new SqlDataAdapter(command);
var dataTable = new DataTable();
adapter.Fill(dataTable);
return dataTable;
}
}
}
}
2.3 在控制器中使用ADO.NET
查询数据并绑定到视图：
public class UserController : Controller
{
private readonly DbHelper _dbHelper;
public UserController(IConfiguration configuration)
{
_dbHelper = new DbHelper(configuration);
}
public IActionResult Index()
{
var sql = "SELECT * FROM Users";
var users = _dbHelper.ExecuteQuery(sql);
return View(users);
}
[HttpPost]
public IActionResult Create(string name, string email)
{
var sql = "INSERT INTO Users (Name, Email) VALUES (@Name, @Email)";
var parameters = new[]
{
new SqlParameter("@Name", name),
new SqlParameter("@Email", email)
};
_dbHelper.ExecuteQuery(sql, parameters);
return RedirectToAction("Index");
}
}
2.4 事务处理
使用`SqlTransaction`确保数据一致性：
public void TransferFunds(int fromAccountId, int toAccountId, decimal amount)
{
using (var connection = _dbHelper.GetConnection())
{
connection.Open();
using (var transaction = connection.BeginTransaction())
{
try
{
var sql1 = "UPDATE Accounts SET Balance = Balance - @Amount WHERE Id = @FromId";
var cmd1 = new SqlCommand(sql1, connection, transaction);
cmd1.Parameters.AddWithValue("@Amount", amount);
cmd1.Parameters.AddWithValue("@FromId", fromAccountId);
cmd1.ExecuteNonQuery();
var sql2 = "UPDATE Accounts SET Balance = Balance + @Amount WHERE Id = @ToId";
var cmd2 = new SqlCommand(sql2, connection, transaction);
cmd2.Parameters.AddWithValue("@Amount", amount);
cmd2.Parameters.AddWithValue("@ToId", toAccountId);
cmd2.ExecuteNonQuery();
transaction.Commit();
}
catch
{
transaction.Rollback();
throw;
}
}
}
}
三、方法三：使用Dapper轻量级ORM
Dapper是一个微型的ORM框架，由Stack Overflow团队开发，它通过扩展`IDbConnection`提供高效的映射功能，性能接近原生ADO.NET，同时减少了重复代码。
3.1 安装Dapper NuGet包
Install-Package Dapper
3.2 创建数据访问层
封装一个`UserRepository`类：
public class UserRepository
{
private readonly string _connectionString;
public UserRepository(IConfiguration configuration)
{
_connectionString = configuration.GetConnectionString("LocalDb");
}
public IEnumerable GetAllUsers()
{
using (var connection = new SqlConnection(_connectionString))
{
return connection.Query("SELECT * FROM Users");
}
}
public User GetUserById(int id)
{
using (var connection = new SqlConnection(_connectionString))
{
return connection.QueryFirstOrDefault(
"SELECT * FROM Users WHERE Id = @Id",
new { Id = id });
}
}
public int AddUser(User user)
{
using (var connection = new SqlConnection(_connectionString))
{
var sql = "INSERT INTO Users (Name, Email) VALUES (@Name, @Email); SELECT CAST(SCOPE_IDENTITY() AS INT)";
return connection.QuerySingle(sql, user);
}
}
}
3.3 在控制器中使用Dapper
public class UserController : Controller
{
private readonly UserRepository _userRepository;
public UserController(IConfiguration configuration)
{
_userRepository = new UserRepository(configuration);
}
public IActionResult Index()
{
var users = _userRepository.GetAllUsers();
return View(users);
}
[HttpPost]
public IActionResult Create(User user)
{
var userId = _userRepository.AddUser(user);
return RedirectToAction("Details", new { id = userId });
}
}
3.4 存储过程与多映射
调用存储过程并映射多个结果集：
public class OrderRepository
{
public (Order Order, List Items) GetOrderWithItems(int orderId)
{
using (var connection = new SqlConnection(_connectionString))
{
var sql = "EXEC GetOrderWithItems @OrderId";
using (var multi = connection.QueryMultiple(sql, new { OrderId = orderId }))
{
var order = multi.Read().First();
var items = multi.Read().ToList();
return (order, items);
}
}
}
}
四、三种方法对比与选择建议
1. **EF Core**：适合需要快速开发、支持迁移和LINQ查询的中大型项目。优点是代码简洁、支持懒加载和导航属性；缺点是性能略低于原生SQL，启动时加载较慢。
2. **ADO.NET**：适合对性能要求极高或需要精细控制SQL的场景。优点是直接操作数据库，无额外开销；缺点是代码量较大，需手动处理参数和异常。
3. **Dapper**：适合中小型项目或需要平衡性能与开发效率的场景。优点是轻量级、高性能，接近原生SQL；缺点是缺乏EF Core的高级功能（如迁移、变更跟踪）。
五、常见问题与解决方案
1. **连接字符串配置错误**：确保连接字符串中的服务器名称、数据库名称和认证方式正确。对于LocalDB，使用`(localdb)\\mssqllocaldb`。
2. **EF Core迁移失败**：检查`DbContext`是否正确配置，并确保项目引用了对应的数据库提供程序包。
3. **Dapper参数映射问题**：确保参数名称与SQL语句中的占位符一致，或使用匿名对象传递参数。
4. **并发冲突**：在EF Core中使用`ConcurrencyCheck`特性或乐观并发控制，在ADO.NET中手动实现版本号或时间戳。
六、总结
.NET MVC连接本地数据库的三种方法各有优劣，开发者应根据项目规模、性能需求和维护成本综合选择。EF Core提供了最高级别的抽象和开发效率，ADO.NET提供了最大的控制权，而Dapper则在两者之间取得了平衡。掌握这三种方法将显著提升.NET MVC开发者的数据库操作能力。
关键词：.NET MVC、本地数据库连接、Entity Framework Core、ADO.NET、Dapper、ORM、SQL Server、数据库迁移、依赖注入、存储过程
简介：本文详细介绍了.NET MVC中连接本地数据库的三种方法：Entity Framework Core（EF Core）、ADO.NET原生连接和Dapper轻量级ORM。通过代码示例和对比分析，帮助开发者根据项目需求选择合适的数据库访问方案，并提供了常见问题的解决方案。
