如何提升网站pr值,京东可以做特效的网站,建站所有步骤,网站开发的经费预算/本文代码#xff1a;https://download.csdn.net/download/hefeng_aspnet/89935738
概述 Entity Framework Core (EF Core) 已成为 .NET 开发中数据访问的基石工具#xff0c;为开发人员提供了强大而多功能的解决方案。随着 .NET 8 和 C# 10 中引入的改进#xff0c;开发人…
本文代码https://download.csdn.net/download/hefeng_aspnet/89935738
概述 Entity Framework Core (EF Core) 已成为 .NET 开发中数据访问的基石工具为开发人员提供了强大而多功能的解决方案。随着 .NET 8 和 C# 10 中引入的改进开发人员现在可以使用更丰富的功能和增强功能从而进一步增强了 EF Core 的功能。 在本综合指南中我们将深入探讨 Entity Framework Core从基本概念到高级技术。我们深入研究 EF Core 的复杂性利用 C# 10 和 .NET 8 的最新功能为开发人员提供有效使用 EF Core 所需的知识和技能。 在本指南中我们旨在让开发人员深入了解 Entity Framework Core使他们能够在 .NET 生态系统中构建高效、可扩展且可维护的数据驱动应用程序。无论您是新手还是经验丰富的用户本指南都将帮助您在我们的 .NET 项目中充分发挥 Entity Framework Core 的潜力。
Entity Framework Core 入门 我们这些希望在 .NET 中构建数据驱动应用程序的开发人员必须从 Entity Framework Core (EF Core) 开始。EF Core 是一个轻量级、可扩展、跨平台的 ORM对象关系映射器框架可简化数据访问和操作为开发人员提供众多好处。 它抽象了数据库交互的复杂性允许开发人员使用熟悉的 C# 语法处理实体和关系这是 EF Core 的主要优势之一。通过提供对底层数据库的高级抽象EF Core 简化了开发并减少了数据访问所需的样板代码量。 在 .NET 8 项目中安装 EF Core 后开发人员可以使用 EF Core API 来定义数据库上下文、实体和关系。安装后开发人员可以使用 EF Core API 来配置关系。在 EF Core 中DbContext 类表示数据库会话并提供对 DbSet 属性的访问从而实现与实体的交互。
// Example: Creating a DemoDbContext class the file is kept in DbContext Folder in Project EntityFrameworkCoreGuideNET8.Infrastructure.Data
using EntityFrameworkCoreGuideNET8.Infrastructure.Domain.Models; using Microsoft.EntityFrameworkCore;
namespace EntityFrameworkCoreGuideNET8.Infrastructure.Data; public class DemoDbContext: DbContext { public DemoDbContext(DbContextOptions options) : base(options) { } public DbSetUser Users { get; set; } // Other DbSet properties for additional entities protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder) { optionsBuilder.UseSqlServer(OurConnectionString); }
} MyDbContext 类继承自 DbContext并为 User 实体定义一个 DbSet 属性。OnConfiguring 方法将 EF Core 配置为使用 SQL Server 作为数据库提供程序并指定连接字符串。 使用 EF Core开发人员可以在设置数据库上下文后执行 CRUD 操作创建、读取、更新、删除。在 CRUD 操作中操作实体对象并在 DbContext 的 DbSet 属性上调用 Add、Find、Update 和 Remove 等方法。 因此开始使用 Entity Framework Core 需要在 .NET 项目中进行设置定义数据库上下文、实体和关系并使用 EF Core API 执行 CRUD 操作。开发人员可以使用 EF Core 在 .NET 中更高效、更有效地构建数据驱动的应用程序。
使用 LINQ 查询数据 在 Entity Framework Core (EF Core) 中使用 LINQ语言集成查询可让您从数据库中检索数据并使用 C# 语法对其进行操作。为了高效且有效地与数据库交互开发人员可以编写富有表现力且可读的 LINQ 查询来过滤、排序和投影数据。 我们开发人员必须了解 LINQ 的基础知识以及它如何与 EF Core 集成然后才能使用 EF Core 中的 LINQ 查询数据。C# 的 LINQ 语言扩展允许开发人员使用统一的语法从各种数据源查询数据。借助 EF Core开发人员可以通过将 LINQ 查询转换为针对底层数据库执行的 SQL 查询直观而熟悉地处理实体数据。 在 EF Core 中使用 LINQ 需要了解延迟执行的概念。在 EF Core 中LINQ 查询是延迟执行的这意味着它们不会在定义时立即执行而是在访问或枚举查询结果时执行。通过延迟执行开发人员可以构建复杂的查询并应用其他操作例如过滤或排序然后再对数据库执行这些操作。 IQueryable 表示可以在执行之前进一步修改或编写的查询这是 EF Core 中 LINQ 的另一个关键功能。借助 IQueryable开发人员可以根据运行时条件或用户输入动态构建查询从而允许他们动态地过滤、排序和投影数据。
// Example: Creating a UserRepository class the file is kept in Repository Folder in Project EntityFrameworkCoreGuideNET8.Infrastructure.Data using EntityFrameworkCoreGuideNET8.Infrastructure.Domain.Interfaces; using EntityFrameworkCoreGuideNET8.Infrastructure.Domain.Models; using Microsoft.EntityFrameworkCore;
namespace EntityFrameworkCoreGuideNET8.Infrastructure.Data.Repository; public class UserRepository : IUserRepository { private readonly DemoDbContext _dbContext; private bool _disposed false; public UserRepository(DemoDbContext dbContext) { _dbContext dbContext; } /// summary /// This is an Example Querying data with LINQ /// /summary /// returnsList/returns public TaskListUser GetAllActiveUsersAsync() _dbContext.Users .Where(u u.IsActive) .OrderBy(u u.LastName) .ThenBy(u u.FirstName) .ToListAsync(); protected virtual void Dispose(bool disposing) { if (_disposed) return; if (disposing) { _dbContext.Dispose(); } _disposed true; } public void Dispose() { Dispose(true); GC.SuppressFinalize(this); } } 在上述代码示例中LINQ 查询根据用户的年龄筛选用户按姓氏排序并仅选择用户的名字和姓氏。LINQ 运算符可以链接在一起以构建复杂的查询这些查询可以使用 IQueryable 接口对数据库高效执行。 简而言之在 EF Core 中使用 LINQ 查询数据是一种灵活而强大的与数据库交互的方式。通过了解 LINQ 语法、延迟执行和 IQueryable 接口开发人员可以编写满足其应用程序需求的富有表现力且高效的查询。
使用迁移 为了管理数据库架构更改并确保一致性和完整性使用 Entity Framework Core (EF Core) 中的迁移至关重要。开发人员可以使用迁移来随时间推移改进数据库架构同时保留现有数据并确保版本之间的平稳过渡。 开发人员需要了解迁移的基础知识及其工作原理才能开始使用 EF Core 迁移。通过使用迁移开发人员可以使用 C# 代码定义和应用对数据库架构的更改而不是手动更改数据库。这种方法的优点是可以控制数据库架构更改、重复数据库更新并自动化部署管道。 使用 Entity Framework Core生成和应用迁移的过程非常简单。开发人员可以根据实体模型的更改生成迁移并使用 CLI命令行界面将其应用于数据库。开发人员可以使用以下命令创建名为“InitialCreate”的新迁移
dotnet ef migrations add InitialCreate
一旦生成迁移开发人员就可以使用以下命令将其应用到数据库
dotnet ef database update EF Core 提供的内置工具还可用于管理 Visual Studio 2022 IDE 中的迁移。通过右键单击包含 DbContext 的项目并选择“添加 新脚手架项”开发人员可以选择“EF Core 迁移”并按照提示创建新的迁移。同样开发人员可以通过右键单击项目并选择“更新数据库”来应用迁移。 此外除了管理架构更改之外EF Core 迁移还支持数据迁移和播种初始数据。开发人员可以使用数据迁移在迁移过程中填充或转换数据从而确保数据库在架构更改后保持一致。在迁移代码中开发人员可以使用 migrationBuilder 对象执行 SQL 命令或操作数据。在 DbContext 的 OnModelCreating 方法中播种初始数据涉及在创建或更新模型时将预定义数据插入数据库。 因此在 EF Core 中使用迁移时管理数据库架构更改、应用更新和确保数据一致性至关重要。通过了解迁移的基础知识并使用 Visual Studio 2022 IDE 和 EF Core 提供的工具开发人员可以有效地管理数据库架构更改并维护其应用程序数据的完整性。
高级概念和技术 通过了解 Entity Framework Core (EF Core) 中的高级概念和技术开发人员可以优化性能、实现复杂功能并优化其应用程序的效率。通过掌握这些技术并最大限度地发挥 EF Core 的潜力开发人员可以构建高性能、可扩展的应用程序。 EF Core 提供三种加载策略预先加载、延迟加载和显式加载。开发人员可以使用预先加载在单个查询中将相关实体与主实体一起加载从而减少数据库往返次数。延迟加载仅在需要时加载数据延迟加载会推迟加载相关实体直到访问它们为止。开发人员可以指定何时显式加载相关实体从而更有效地检索数据。
// Example: Creating a UserRepository class the file is kept in Models Folder in Project EntityFrameworkCoreGuideNET8.Domain using System.ComponentModel.DataAnnotations; using System.ComponentModel.DataAnnotations.Schema;
namespace EntityFrameworkCoreGuideNET8.Infrastructure.Domain.Models; public record Order { [Key] public Guid Id { get; init; } public Guid UserId { get; init; } [ForeignKey(UserId)] public required User User { get; init; } [Required] public string ProductName { get; init; }string.Empty; [Required,Range(0, double.MaxValue, ErrorMessage Price must be a positive value.)] public decimal Price { get; init; } [Required] public DateTime OrderDate { get; init; }
} // Example: Creating a UserRepository class the file is kept in Repository Folder in Project EntityFrameworkCoreGuideNET8.Infrastructure.Data using EntityFrameworkCoreGuideNET8.Infrastructure.Domain.Interfaces; using EntityFrameworkCoreGuideNET8.Infrastructure.Domain.Models; using Microsoft.EntityFrameworkCore;
namespace EntityFrameworkCoreGuideNET8.Infrastructure.Data.Repository; public class UserRepository : IUserRepository { private readonly DemoDbContext _dbContext; private bool _disposed false; public UserRepository(DemoDbContext dbContext) { _dbContext dbContext ?? throw new ArgumentNullException(nameof(dbContext)); } /// summary /// This is an Example Querying data with LINQ /// /summary /// returnsList/returns public TaskListUser GetAllActiveUsersAsync() _dbContext.Users .Where(u u.IsActive) .OrderBy(u u.LastName) .ThenBy(u u.FirstName) .ToListAsync(); /// summary /// This example is Eager loading in EF Core /// /summary /// returns/returns public TaskListUser LoadUsersWithOrdersAsync() _dbContext.Users .Include(uu.Orders) .Where(u u.IsActive) .OrderBy(u u.LastName) .ThenBy(u u.FirstName) .ToListAsync(); protected virtual void Dispose(bool disposing) { if (_disposed) return; if (disposing) { _dbContext.Dispose(); } _disposed true; } public void Dispose() { Dispose(true); GC.SuppressFinalize(this); } } 为了在 EF Core 应用程序中保持数据一致性和完整性事务至关重要。通过将多个数据库操作组合成一个原子工作单元开发人员可以确保所有操作都成功或者都不应用。除了防止数据损坏之外这还可以确保数据库保持一致。 在使用存储过程和原始 SQL 查询时EF Core 为开发人员提供了灵活性和性能优化机会。通过在存储过程中封装复杂的逻辑和业务规则开发人员可以在提高性能的同时提高性能和安全性。为了获得更好的控制和性能优化开发人员可以使用原始 SQL 查询直接对数据库执行 SQL 命令从而绕过 EF Core 的查询转换机制。 通过使用缓存和批处理优化性能可以显著提高 EF Core 应用程序的效率。开发人员可以将经常访问的数据缓存在内存中从而减少需要进行的数据库查询次数并提高应用程序的响应能力。通过将多个数据库操作组合成一个批处理批处理可以最大限度地减少往返次数并通过最大限度地减少延迟来提高整体性能。 我们开发人员可以通过掌握 EF Core 中的高级概念和技术例如加载策略、事务、存储过程、原始 SQL 查询、缓存和批处理来构建高性能、可扩展的应用程序。借助这些技术开发人员可以优化性能、实现复杂的功能并为他们的 EF Core 应用程序提供卓越的用户体验。
将 Entity Framework Core 与 ASP.NET Core 集成 Web 开发人员可以使用 ASP.NET Core 和 Entity Framework Core (EF Core) 构建可扩展且强大的 Web 应用程序。开发人员可以基于 ASP.NET Core 和 EF Core 的强大功能实施最佳实践和设计模式从而确保其 API 的安全性、性能和可维护性。 实现存储库模式和工作单元是构建 RESTful API 的重要组成部分。存储库模式将应用程序的业务逻辑与数据访问逻辑分开。通过将数据访问操作封装在存储库中并在工作单元中协调事务开发人员可以更好地分离关注点并提高代码的可测试性。 使用 EF Core 构建 API 需要处理并发和乐观锁定。多个用户可以尝试同时修改相同的数据从而导致并发问题。开发人员可以通过实施乐观锁定机制例如行版本控制或时间戳列来优雅地检测和解决冲突从而确保多用户环境中的数据完整性和一致性。 为了保护敏感信息并满足安全要求授权和身份验证至关重要。 ASP.NET Core 提供了强大的身份验证和授权机制包括 JWTJSON Web 令牌、OAuth 和 OpenID Connect。开发人员可以通过配置身份验证和授权策略根据用户角色、权限和其他标准控制对 API 端点的访问。
// Example: is using Program.cs file is kept in Project EntityFrameworkCoreGuideNET8.Business.UI, which is ASP.net Core MVC Project using EntityFrameworkCoreGuideNET8.Business.UI.Extensions;
var builder WebApplication.CreateBuilder(args);
// Add services to the container. builder.Services.AddControllersWithViews();
// Example: Configuring authentication and authorization in ASP.NET Core builder.Services.AddJwtAuthentication(builder.Configuration);
builder.Services.AddAdminAuthorization(); var app builder.Build();
// Configure the HTTP request pipeline. if (!app.Environment.IsDevelopment()) { app.UseExceptionHandler(/Home/Error); // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts. app.UseHsts(); }
app.UseHttpsRedirection(); app.UseStaticFiles();
app.UseRouting();
app.UseAuthorization();
app.MapControllerRoute( name: default, pattern: {controllerHome}/{actionIndex}/{id?});
app.Run(); // Example: Creating a JwtAuthentication.cs class the file is kept in Extensions Folder in Project EntityFrameworkCoreGuideNET8.Business.UI
using Microsoft.AspNetCore.Authentication.JwtBearer; using Microsoft.IdentityModel.Tokens; using System.Text;
namespace EntityFrameworkCoreGuideNET8.Business.UI.Extensions; public static class JwtAuthentication { public static void AddJwtAuthentication(this IServiceCollection services, IConfiguration configuration) { // Example: Configuring authentication and authorization in ASP.NET Core services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme) .AddJwtBearer(options { options.TokenValidationParameters new TokenValidationParameters { ValidateIssuer true, ValidateAudience true, ValidateLifetime true, ValidateIssuerSigningKey true, ValidIssuer configuration[Jwt:Issuer], ValidAudience configuration[Jwt:Audience], IssuerSigningKey new SymmetricSecurityKey(Encoding.UTF8.GetBytes(configuration[Jwt:Key])) }; }); } } // Example: Creating a Authorization.cs class the file is kept in Extensions Folder in Project EntityFrameworkCoreGuideNET8.Business.UI namespace EntityFrameworkCoreGuideNET8.Business.UI.Extensions; public static class Authorization { public static void AddAdminAuthorization(this IServiceCollection services) { services.AddAuthorization(options { options.AddPolicy(AdminOnly, policy { policy.RequireRole(Admin); }); }); } } 使用 ASP.NET Core 和 EF Core需要实现最佳实践例如存储库模式和工作单元、处理并发和乐观锁定以及通过身份验证和授权保护数据访问。这些最佳实践使开发人员能够构建可扩展、安全且可维护的 API。
Entity Framework Core 的 C# 10 功能 利用 C# 10 中引入的新功能可以极大地增强我们使用 Entity Framework Core (EF Core) 开发的经验。通过利用这些功能开发人员可以简化他们的代码提高可读性并提高生产力。 C# 10 中最值得注意的功能之一就是记录类型的使用。记录类型提供了一种简洁而富有表现力的方式来定义不可变数据类型使其成为需要实体表示的 EF Core 应用程序的理想选择。由于对实体类使用记录类型开发人员可以减少样板代码并提高代码清晰度。
// Example: Using record types for entity classes public record User { public int Id { get; init; } public string FirstName { get; init; } public string LastName { get; init; } } 此外C# 10 引入了许多模式匹配增强功能这些功能对 EF Core 开发大有裨益。开发人员可以使用模式匹配增强功能简化复杂代码并提高可维护性。通过使用模式匹配增强功能开发人员可以编写更具表现力和简洁的代码来处理条件逻辑。 在 C# 10 中引入了可空引用类型。可空引用类型允许开发人员注释其代码以指示允许或不允许空值的位置。开发人员可以通过使用可空引用类型来降低 EF Core 应用程序中出现运行时错误的可能性从而使其代码更加健壮并防止出现空引用异常。 通过利用 C# 10 中引入的最新功能例如记录类型、模式匹配增强功能和可空引用类型Web 开发人员可以改善 Entity Framework Core 开发体验从而获得更高效、更强大且更易于维护的代码库。借助这些功能和 EF Core开发人员可以轻松构建高质量、可扩展的应用程序。
Entity Framework Core 性能优化 Entity Framework Core (EF Core) 应用程序必须了解性能优化技术以确保高效的数据库操作。通过优化数据库操作开发人员可以显著增强其应用程序的性能和响应能力从而提供更好的用户体验和更高的可扩展性。 为了优化查询执行数据库索引有助于提供一种快速方法来定位数据库表中的特定行从而加快查询执行速度。通过在经常查询的列上创建索引开发人员可以减少从数据库检索数据所需的时间从而提高查询性能。 通过优化查询还可以显著提高查询的性能。通过精心设计查询开发人员可以最大限度地减少从数据库检索的数据量并最大限度地利用索引。可以使用多种技术来提高查询性能包括避免不必要的连接、仅选择必要的列以及使用 WHERE 子句过滤数据。 通过将经常访问的数据缓存在内存中开发人员可以减少数据库查询的数量并提高应用程序的响应能力这对于性能优化也至关重要。使用 Redis 等内存缓存框架或实施分布式缓存解决方案可以帮助最大限度地减少数据库负载并提高应用程序性能。 为了有效优化性能开发人员还必须监控和分析性能指标以确定瓶颈和需要改进的领域。开发人员可以使用 Entity Framework Profiler 或 SQL Server Management Studio 等工具来查明性能问题并采取纠正措施这些工具可以深入了解查询执行时间、数据库负载和资源利用率。
// Example: Creating a DemoDbContext class the file is kept in DbContext Folder in Project EntityFrameworkCoreGuideNET8.Infrastructure.Data
using EntityFrameworkCoreGuideNET8.Infrastructure.Domain.Models; using Microsoft.EntityFrameworkCore;
namespace EntityFrameworkCoreGuideNET8.Infrastructure.Data; public class DemoDbContext: DbContext { public DemoDbContext(DbContextOptions options) : base(options) { } public DbSetUser Users { get; set; } // Other DbSet properties for additional entities protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder) { optionsBuilder.UseSqlServer(OurConnectionString); } // Example: Creating a database index in EF Core protected override void OnModelCreating(ModelBuilder modelBuilder) { modelBuilder.EntityUser() .HasIndex(u u.Email) .IsUnique(); }
} 我们开发人员可以通过使用性能优化技术如数据库索引、优化查询、实施缓存策略和监控性能指标来提高其 EF Core 应用程序的性能。通过将这些技术与仔细的分析和调整相结合可以实现显着的性能改进和更好的用户体验。
测试 Entity Framework Core 应用程序 测试对于 Entity Framework Core (EF Core) 应用程序的可靠性和可维护性至关重要。通过全面测试我们的代码库您可以在开发生命周期的早期识别和解决潜在问题从而降低生产环境中出现错误和错误的风险。 可以使用不同类型的测试方法来测试 EF Core 应用程序例如单元测试、集成测试和模拟框架。单独测试单个组件和代码单元称为单元测试。相比之下集成测试涉及确保不同的组件或模块能够顺利协同工作。 作为在 EF Core 应用程序中测试数据库交互的一种方式开发人员经常使用模拟框架来模拟数据库行为而无需实际访问数据库。您可以通过使用模拟框架创建模拟真实数据库对象行为的模拟对象来隔离我们的测试而无需依赖外部依赖项。 设置内存数据库或使用模拟库也是测试 EF Core 应用程序的有用技术。使用内存数据库您可以针对仅存在于内存中的临时数据库运行测试从而为传统数据库系统提供轻量级且快速的替代方案。通过为数据库操作创建模拟对象模拟库消除了在测试期间与物理数据库交互的需要。 通过实施单元测试、集成测试、模拟框架以及内存数据库或模拟库等测试策略我们的 EF Core 应用程序的可靠性和可维护性可以得到极大提高。如果您投入时间和精力进行测试我们的软件将发挥最佳性能。
//DbContextMocker.cs class the file is kept in Project EntityFrameworkCoreGuideNET8.Tests using EntityFrameworkCoreGuideNET8.Infrastructure.Data; using Microsoft.EntityFrameworkCore;
namespace EntityFrameworkCoreGuideNET8.Tests; public static class DbContextMocker { public static DemoDbContext GetDemoDbContext(string dbName) { var options new DbContextOptionsBuilderDemoDbContext() .UseInMemoryDatabase(databaseName: dbName) .Options; var dbContext new DemoDbContext(options); // Seed your in-memory database with test data if needed return dbContext; } } //UserRepositoryTests.cs class the file is kept in Project EntityFrameworkCoreGuideNET8.Tests using EntityFrameworkCoreGuideNET8.Infrastructure.Data.Repository;
namespace EntityFrameworkCoreGuideNET8.Tests;
public class UserRepositoryTests { // Example: Writing unit tests for EF Core repositories [Fact] public async Task GetUsers_ReturnsAllUsers() { // Arrange var dbContext DbContextMocker.GetDemoDbContext(nameof(GetUsers_ReturnsAllUsers)); var repository new UserRepository(dbContext); // Act var users await repository.GetAllActiveUsersAsync(); // Assert Assert.Equal(3, users.Count); }
}
Entity Framework Core 最佳实践
保持代码质量和一致性 使用 Entity Framework Core (EF Core) 时保持代码质量和一致性对于确保应用程序的稳健性和可维护性至关重要。通过遵守推荐的最佳实践和惯例开发人员可以简化开发、提高代码可读性并最大限度地减少潜在问题。让我们探索其中一些最佳实践。
// Example: Creating a DemoDbContext class the file is kept in DbContext Folder in Project EntityFrameworkCoreGuideNET8.Infrastructure.Data
using EntityFrameworkCoreGuideNET8.Infrastructure.Domain.Models; using Microsoft.EntityFrameworkCore;
namespace EntityFrameworkCoreGuideNET8.Infrastructure.Data; public class DemoDbContext: DbContext { public DemoDbContext(DbContextOptions options) : base(options) { } public DbSetUser Users { get; set; } // Other DbSet properties for additional entities protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder) { optionsBuilder.UseSqlServer(OurConnectionString); } // Example: Creating a database index in EF Core protected override void OnModelCreating(ModelBuilder modelBuilder) { modelBuilder.EntityUser() .HasIndex(u u.Email) .IsUnique(); // Fluent API configurations modelBuilder.EntityUser() .Property(e e.Id) .IsRequired(); }
} using EntityFrameworkCoreGuideNET8.Infrastructure.Data; using Microsoft.EntityFrameworkCore;
Console.WriteLine(Hello, from Ziggy Rafiq!);
using (var context new DemoDbContext(new DbContextOptionsBuilderDemoDbContext() .UseSqlServer(our_connection_string_here).Options)) { // Use context to interact with the database }
使用有意义的命名约定
为实体、属性和方法选择描述性名称以增强代码的可读性和理解性。
// Example: Creating a User record the file is kept in Models Folder in Project EntityFrameworkCoreGuideNET8.Infrastructure.Data using System.ComponentModel.DataAnnotations;
namespace EntityFrameworkCoreGuideNET8.Infrastructure.Domain.Models; public record User { [Key] public Guid Id { get; init; } public ListOrder Orders { get; init; } new ListOrder(); [Required] public string FirstName { get; init; } string.Empty; [Required] public string LastName { get; init; } string.Empty; [Required] public string Email { get; init; } string.Empty; [Required] public string EmailConfirmed { get; init; } string.Empty; [Required] public string Phone { get; init; } string.Empty; [Required] public string PhoneConfirmed { get; init; } string.Empty; public bool IsActive { get; init; } false; [Timestamp] public byte[]? RowVersion { get; set; } }
保持 DbContext 精简且专注
避免用不必要的配置或依赖项来扰乱 DbContext 类。专注于定义实体及其关系。
// Example: Creating a DemoDbContext class the file is kept in DbContext Folder in Project EntityFrameworkCoreGuideNET8.Infrastructure.Data
using EntityFrameworkCoreGuideNET8.Infrastructure.Domain.Models; using Microsoft.EntityFrameworkCore;
namespace EntityFrameworkCoreGuideNET8.Infrastructure.Data; public class DemoDbContext: DbContext { public DemoDbContext(DbContextOptions options) : base(options) { } public DbSetUser Users { get; set; } // Other DbSet properties for additional entities protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder) { optionsBuilder.UseSqlServer(OurConnectionString); } }
使用数据注释或 Fluent API
一致地选择数据注释或 Fluent API 来配置实体和关系。对于更复杂的配置最好使用 Fluent API。
// Example: Creating a User record the file is kept in Models Folder in Project EntityFrameworkCoreGuideNET8.Infrastructure.Data using System.ComponentModel.DataAnnotations;
namespace EntityFrameworkCoreGuideNET8.Infrastructure.Domain.Models; public record User { [Key] public Guid Id { get; init; } public ListOrder Orders { get; init; } new ListOrder(); [Required] public string FirstName { get; init; } string.Empty; [Required] public string LastName { get; init; } string.Empty; [Required] public string Email { get; init; } string.Empty; [Required] public string EmailConfirmed { get; init; } string.Empty; [Required] public string Phone { get; init; } string.Empty; [Required] public string PhoneConfirmed { get; init; } string.Empty; public bool IsActive { get; init; } false; [Timestamp] public byte[]? RowVersion { get; set; } } // Example: Creating a UserRepository class the file is kept in Models Folder in Project EntityFrameworkCoreGuideNET8.Domain using System.ComponentModel.DataAnnotations; using System.ComponentModel.DataAnnotations.Schema;
namespace EntityFrameworkCoreGuideNET8.Infrastructure.Domain.Models; public record Order { [Key] public Guid Id { get; init; } public Guid UserId { get; init; } [ForeignKey(UserId)] public required User User { get; init; } [Required] public string ProductName { get; init; }string.Empty; [Required,Range(0, double.MaxValue, ErrorMessage Price must be a positive value.)] public decimal Price { get; init; } [Required] public DateTime OrderDate { get; init; }
}
使用时间戳处理并发
当多个用户同时更新同一个实体时使用时间戳例如RowVersion来处理并发冲突。
// Example: Creating a User record the file is kept in Models Folder in Project EntityFrameworkCoreGuideNET8.Infrastructure.Data using System.ComponentModel.DataAnnotations;
namespace EntityFrameworkCoreGuideNET8.Infrastructure.Domain.Models; public record User { [Key] public Guid Id { get; init; } public ListOrder Orders { get; init; } new ListOrder(); [Required] public string FirstName { get; init; } string.Empty; [Required] public string LastName { get; init; } string.Empty; [Required] public string Email { get; init; } string.Empty; [Required] public string EmailConfirmed { get; init; } string.Empty; [Required] public string Phone { get; init; } string.Empty; [Required] public string PhoneConfirmed { get; init; } string.Empty; public bool IsActive { get; init; } false; [Timestamp] public byte[]? RowVersion { get; set; } }
优化数据库交互
通过适当使用预先加载、显式加载或延迟加载来最大限度地减少数据库往返次数。通过在需要时预先加载相关实体来避免 N1 查询问题。
// Eager loading example var users dbContext.Users.Include(u u.Orders).ToList();
妥善处理异常
实现错误处理机制以便妥善处理 EF Core 操作引发的异常。使用 try-catch 块捕获特定异常并向用户提供有意义的错误消息。
// Example: Creating a UserRepository class the file is kept in Repository Folder in Project EntityFrameworkCoreGuideNET8.Infrastructure.Data using EntityFrameworkCoreGuideNET8.Infrastructure.Domain.DTOs; using EntityFrameworkCoreGuideNET8.Infrastructure.Domain.Interfaces; using EntityFrameworkCoreGuideNET8.Infrastructure.Domain.Models; using Microsoft.EntityFrameworkCore;
namespace EntityFrameworkCoreGuideNET8.Infrastructure.Data.Repository; public class UserRepository : IUserRepository { private readonly DemoDbContext _dbContext; private bool _disposed false; public UserRepository(DemoDbContext dbContext) { _dbContext dbContext ?? throw new ArgumentNullException(nameof(dbContext)); } /// summary /// Add or Updates the User /// /summary /// param nameuserUser Model/param /// returns/returns public async Task SaveAsync(User user) { try { _dbContext.Entry(user).State user.Id Guid.Empty ? EntityState.Added : EntityState.Modified; await _dbContext.SaveChangesAsync(); } catch (DbUpdateException ex) { Console.WriteLine(An error occurred while saving changes to the database: ex.Message); } } protected virtual void Dispose(bool disposing) { if (_disposed) return; if (disposing) { _dbContext.Dispose(); } _disposed true; } public void Dispose() { Dispose(true); GC.SuppressFinalize(this); } } 通过遵循这些最佳实践和惯例开发人员可以在使用 Entity Framework Core 时保持代码质量、一致性和可靠性。这些实践有助于在 .NET 生态系统中构建可扩展、可维护且高效的应用程序。
使用 DTO数据传输对象 在 ASP.NET Core 应用程序中使用 Entity Framework Core (EF Core) 时利用数据传输对象 (DTO) 进行投影可带来许多好处包括提高性能、减少数据传输和增强安全性。此外避免在控制器中直接使用 DbSet 有助于保持关注点分离并促进更清晰、更易于维护的代码。让我们深入研究实现 DTO 和避免在控制器中直接使用 DbSet 的最佳实践
实现投影的 DTO 创建针对特定用例定制的 DTO 类以在我们的应用程序层之间传输数据。DTO 允许您根据客户端的需要精确地调整从 EF Core 查询返回的数据而无需直接公开我们的域实体。
// DTOs.cs file in Project EntityFrameworkCoreGuideNET8.Infrastructure.Data namespace EntityFrameworkCoreGuideNET8.Infrastructure.Domain.DTOs; public record UserDto(Guid Id, string FirstName, string LastName, string Email, string Phone, bool IsActive); public record OrderDto(Guid Id, Guid UserId, string ProductName, decimal Price, DateTime OrderDate);
使用投影填充 DTO 从 EF Core 查询数据时使用投影将查询结果直接映射到 DTO。此方法减少了通过网络传输的数据量并通过仅获取所需字段来提高性能。
// Example: Creating a UserRepository class the file is kept in Repository Folder in Project EntityFrameworkCoreGuideNET8.Infrastructure.Data using EntityFrameworkCoreGuideNET8.Infrastructure.Domain.DTOs; using EntityFrameworkCoreGuideNET8.Infrastructure.Domain.Interfaces; using EntityFrameworkCoreGuideNET8.Infrastructure.Domain.Models; using Microsoft.EntityFrameworkCore;
namespace EntityFrameworkCoreGuideNET8.Infrastructure.Data.Repository; public class UserRepository : IUserRepository { private readonly DemoDbContext _dbContext; private bool _disposed false; public UserRepository(DemoDbContext dbContext) { _dbContext dbContext ?? throw new ArgumentNullException(nameof(dbContext)); } /// summary /// This example demonstrates the usage of UserDto for accessing the data. /// /summary /// returnsList of Users/returns public TaskListUserDto GetUserDtosAsync() _dbContext.Users .Select(u new UserDto( u.Id, u.FirstName, u.LastName, u.Email, u.Phone, u.IsActive )) .ToListAsync(); protected virtual void Dispose(bool disposing) { if (_disposed) return; if (disposing) { _dbContext.Dispose(); } _disposed true; } public void Dispose() { Dispose(true); GC.SuppressFinalize(this); } }
避免在控制器中直接使用 DbSet 不要直接从控制器返回 DbSet而是将数据投影到 DTO 中以确保只向客户端公开必要的数据。这种方法有助于防止过度获取数据并最大限度地降低与公开域实体相关的潜在安全风险。
[ApiController] [Route(api/users)] public class UserController : ControllerBase { private readonly MyDbContext _dbContext; public UserController(MyDbContext dbContext) { _dbContext dbContext; } [HttpGet] public ActionResultIEnumerableUserDto GetUsers() { var userDtos _dbContext.Users .Select(u new UserDto { UserId u.UserId, UserName u.UserName, // Map other properties as needed... }) .ToList(); return Ok(userDtos); } } 通过利用 DTO 进行投影并避免在控制器中直接使用 DbSet开发人员可以设计更高效、更安全且更易于维护的 ASP.NET Core 应用程序。这种方法有助于更好地分离关注点、提高性能并提高整体代码质量。
确保妥善处理并发冲突 确保妥善处理并发冲突、实现日志记录和错误处理以及定期更新 EF Core 及其依赖项是维护 ASP.NET Core 应用程序的可靠性、安全性和性能的关键实践。让我们详细探讨这些最佳实践
妥善处理并发冲突 当多个用户尝试同时修改同一数据时可能会发生并发冲突。EF Core 提供了检测和解决这些冲突的机制例如使用时间戳或行版本控制。实施适当的并发控制策略来处理冲突并确保数据完整性。
// Example: Creating a User record the file is kept in Models Folder in Project EntityFrameworkCoreGuideNET8.Infrastructure.Data using System.ComponentModel.DataAnnotations;
namespace EntityFrameworkCoreGuideNET8.Infrastructure.Domain.Models; public record User { [Key] public Guid Id { get; init; } public ListOrder Orders { get; init; } new ListOrder(); [Required] public string FirstName { get; init; } string.Empty; [Required] public string LastName { get; init; } string.Empty; [Required] public string Email { get; init; } string.Empty; [Required] public string EmailConfirmed { get; init; } string.Empty; [Required] public string Phone { get; init; } string.Empty; [Required] public string PhoneConfirmed { get; init; } string.Empty; public bool IsActive { get; init; } false; [Timestamp] public byte[]? RowVersion { get; set; } }
实施日志记录和错误处理 日志记录和错误处理对于识别和诊断生产环境中的问题至关重要。使用 Serilog 或 NLog 等日志记录框架来记录应用程序事件、错误和警告。实施结构化日志记录以捕获相关信息以进行故障排除。
using EntityFrameworkCoreGuideNET8.Business.UI.Models; using EntityFrameworkCoreGuideNET8.Infrastructure.Domain.Interfaces; using Microsoft.AspNetCore.Mvc; using System.Diagnostics;
namespace EntityFrameworkCoreGuideNET8.Business.UI.Controllers { public class HomeController : Controller { private readonly ILoggerHomeController _logger; private readonly IUserService _userService; public HomeController(ILoggerHomeController logger, IUserService userService) { _logger logger; _userService userService; } public IActionResult Index() { return View(); } public IActionResult Privacy() { return View(); } [HttpGet] public async TaskIActionResult GetAllActiveUser() { try { var user await _userService.GetAllActiveUsersAsync(); if (user null) { return NotFound(); } return Ok(user); } catch (Exception ex) { _logger.LogError(ex, An error occurred while retrieving the user.); return StatusCode(500, An unexpected error occurred.); } } [ResponseCache(Duration 0, Location ResponseCacheLocation.None, NoStore true)] public IActionResult Error() { return View(new ErrorViewModel { RequestId Activity.Current?.Id ?? HttpContext.TraceIdentifier }); } } }
定期更新 EF Core 和依赖项 EF Core 会定期发布更新以推出新功能、增强功能和错误修复。及时了解最新的 EF Core 版本并定期更新我们项目的依赖项以利用改进和安全补丁。
dotnet add package Microsoft.EntityFrameworkCore --version x.x.x 通过遵循这些最佳实践开发人员可以增强其 ASP.NET Core 应用程序的可靠性、安全性和性能。妥善处理并发冲突、实现强大的日志记录和错误处理以及保持 EF Core 和依赖项更新是确保应用程序长期成功的关键步骤。
概括 作为现代 .NET 开发的基石Entity Framework Core 提供了强大的数据访问解决方案。通过使用 C# 10 和 .NET 8 的最新功能开发人员可以改善数据库交互、提高性能并提高生产力。通过阅读本综合指南您将能够充分利用 Entity Framework Core。通过掌握这些概念、技术和最佳实践您将确保我们的 .NET 应用程序的可扩展性、可靠性和可维护性。
