(20)ASP.NET Core EF创建模型(必需属性和可选属性、最大长度、并发标记、阴影属性)

简介: (20)ASP.NET Core EF创建模型(必需属性和可选属性、最大长度、并发标记、阴影属性)

1.必需和可选属性

如果实体属性可以包含null,则将其视为可选。如果属性的有效值不可以包含null,则将其视为必需属性。映射到关系 数据库架构时,必需的属性将创建为不可为null的列,而可选属性则创建为可以为null的列。

1.1约定

按照约定,.NET 类型可以包含null的属性将配置为可选,而.NET类型不包含null的属性将根据需要进行配置。例如,具有.net值类型(int、decimal、bool等)的所有属性都是必需的,而具有可为null的.net值类型(int?、decimal?、bool?等)的所有属性都是配置为可选。

1.2数据批注

可以按如下所示将"约定"可以为"可选"的属性配置为"必需":

namespace EFModeling.DataAnnotations.Required
{
    class MyContext : DbContext
    {
        public DbSet<Blog> Blogs { get; set; }
    }
    public class Blog
    {
        public int BlogId { get; set; }
        //加上这个批注,这个值就必需写入
        [Required]
        public string Url { get; set; }
    }
}
1.3Fluent API
namespace EFModeling.FluentAPI.Required
{
    class MyContext : DbContext
    {
        public DbSet<Blog> Blogs { get; set; }
        protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
            modelBuilder.Entity<Blog>()
                .Property(b => b.Url)
                //这个方法表示必需写入
                .IsRequired();
        }
    }
    public class Blog
    {
        public int BlogId { get; set; }
        public string Url { get; set; }
    }
}

2.最大长度

配置最大长度可为数据存储提供有关要对给定属性使用的相应数据类型的提示。最大长度仅适用于数组数据类型,如string和byte[]。例如前端传统数据长度远大于限定的长度,则提示。

2.1约定

按照约定,应由数据库提供程序为属性选择适当的数据类型,即数据库字段设置长度多少,生产程序实体接受值时就限定长度多少。对于具有长度的属性,数据库提供程序通常将选择允许最长数据长度的数据类型。例如,Microsoft SQL Server将对字符string属性使用 nvarchar(max)(如果该列用作键,则会使用nvarchar(450))。

2.2数据批注

你可以使用数据批注为属性配置最大长度。此示例面向SQL Server,因此使用数据类型 nvarchar(500)。

namespace EFModeling.DataAnnotations.MaxLength
{
    class MyContext : DbContext
    {
        public DbSet<Blog> Blogs { get; set; }
    }
    public class Blog
    {
        public int BlogId { get; set; }
        //设置最大长度
        [MaxLength(500)]
        public string Url { get; set; }
    }
}
2.3Fluent API
namespace EFModeling.FluentAPI.MaxLength
{
    class MyContext : DbContext
    {
        public DbSet<Blog> Blogs { get; set; }
        protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
            modelBuilder.Entity<Blog>()
                .Property(b => b.Url)
                //设置最大长度
                .HasMaxLength(500);
        }
    }
    public class Blog
    {
        public int BlogId { get; set; }
        public string Url { get; set; }
    }
}

3.并发标记

当我们发现生产环境某个实体字段经常处于并发当中,我们可以批注一下为并发字段。

3.1约定

按照约定,属性永远不会配置为并发标记。

3.2数据注释

您可以使用数据批注将属性配置为并发标记。

public class Person
{
   public int PersonId { get; set; }
    //并发标记
    [ConcurrencyCheck]
    public string LastName { get; set; }
    public string FirstName { get; set; }
}
3.3Fluent API

您可以使用熟知的API将属性配置为并发标记。

class MyContext : DbContext
{
    public DbSet<Person> People { get; set; }
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Person>()
            .Property(p => p.LastName)
            //并发标记
            .IsConcurrencyToken();
    }
}
public class Person
{
    public int PersonId { get; set; }
    public string LastName { get; set; }
    public string FirstName { get; set; }
}

4.时间戳/行版本

时间戳是一个属性类型,在每次插入或更新行时,数据库都会生成一个新值。此该属性类型也被视为并发标记。这可以确保在你和其他人修改了行数据时你会收到异常信息。

4.1约定

按照约定,属性永远不会配置为时间戳。

4.2数据注释

你可以使用数据批注将属性配置为时间戳。

public class Blog
{
    public int BlogId { get; set; }
    public string Url { get; set; }
    //设置时间戳
    [Timestamp]
    public byte[] Timestamp { get; set; }
}
4.3Fluent API

你可以使用熟知的API将属性配置为时间戳。

class MyContext : DbContext
{
    public DbSet<Blog> Blogs { get; set; }
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Blog>()
            .Property(p => p.Timestamp)
            //设置时间戳
            .IsRowVersion();
    }
}
public class Blog
{
    public int BlogId { get; set; }
    public string Url { get; set; }
    public byte[] Timestamp { get; set; }
}

5.阴影属性

当数据库中的数据不应在映射的实体类型上公开时,阴影属性非常有用。它们最常用于外键属性,其中两个实体之间的关系由数据库中的外键值表示,但使用实体类型之间的导航属性在实体类型上管理关系,可以通过ChangeTracker API获取和更改影子属性值:

context.Entry(myBlog).Property("LastUpdated").CurrentValue = DateTime.Now;
可以通过EF.Property静态方法在LINQ查询中引用影子属性:
var blogs = context.Blogs.OrderBy(b => EF.Property<DateTime>(b, "LastUpdated"));
5.1约定

如果发现了关系,但在依赖实体类中找不到外键属性,则可以按约定创建阴影属性。在这种情况下,将引入阴影外键属性。影子外键属性将命名<navigation property name><principal key property name>为(指向主体实体的依赖实体上的导航用于命名)。如果主体键属性名称包含导航属性的名称,则该名称将只是<principal key property name>。如果依赖实体上没有导航属性,则会在其位置使用主体类型名称。

例如,下面的代码列表将导致BlogId Post向实体引入阴影属性。

class MyContext : DbContext
{
    public DbSet<Blog> Blogs { get; set; }
    public DbSet<Post> Posts { get; set; }
}
public class Blog
{
    public int BlogId { get; set; }
    public string Url { get; set; }
    //阴影属性
    public List<Post> Posts { get; set; }
}
public class Post
{
    public int PostId { get; set; }
    public string Title { get; set; }
    public string Content { get; set; }
     //阴影属性
    public Blog Blog { get; set; }
}
5.2数据注释

不能通过数据批注创建阴影属性。

5.3Fluent API

你可以使用"熟知API"配置阴影属性。一旦你调用了Property方法的字符串重载,就可以链接到其他属性的任何配置调用。如果提供Property方法的名称与现有属性的名称相匹配(一个阴影属性或在实体类中定义的属性),则代码将配置该现有属性,而不是引入新的阴影属性。

class MyContext : DbContext
{
    public DbSet<Blog> Blogs { get; set; }
    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Blog>()
            //创建阴影属性
            .Property<DateTime>("LastUpdated");
    }
}
public class Blog
{
    public int BlogId { get; set; }
    public string Url { get; set; }
}

参考文献:

必需和可选属性

最大长度

并发标记

阴影属性

相关文章
|
12天前
|
开发框架 .NET 开发者
简化 ASP.NET Core 依赖注入(DI)注册-Scrutor
Scrutor 是一个简化 ASP.NET Core 应用程序中依赖注入(DI)注册过程的开源库,支持自动扫描和注册服务。通过简单的配置,开发者可以轻松地从指定程序集中筛选、注册服务,并设置其生命周期,同时支持服务装饰等高级功能。适用于大型项目,提高代码的可维护性和简洁性。仓库地址:&lt;https://github.com/khellang/Scrutor&gt;
34 5
|
2月前
|
存储 开发框架 JSON
ASP.NET Core OData 9 正式发布
【10月更文挑战第8天】Microsoft 在 2024 年 8 月 30 日宣布推出 ASP.NET Core OData 9,此版本与 .NET 8 的 OData 库保持一致,改进了数据编码以符合 OData 规范,并放弃了对旧版 .NET Framework 的支持,仅支持 .NET 8 及更高版本。新版本引入了更快的 JSON 编写器 `System.Text.UTF8JsonWriter`,优化了内存使用和序列化速度。
|
1月前
|
开发框架 .NET C#
在 ASP.NET Core 中创建 gRPC 客户端和服务器
本文介绍了如何使用 gRPC 框架搭建一个简单的“Hello World”示例。首先创建了一个名为 GrpcDemo 的解决方案,其中包含一个 gRPC 服务端项目 GrpcServer 和一个客户端项目 GrpcClient。服务端通过定义 `greeter.proto` 文件中的服务和消息类型,实现了一个简单的问候服务 `GreeterService`。客户端则通过 gRPC 客户端库连接到服务端并调用其 `SayHello` 方法,展示了 gRPC 在 C# 中的基本使用方法。
40 5
在 ASP.NET Core 中创建 gRPC 客户端和服务器
|
20天前
|
开发框架 缓存 .NET
GraphQL 与 ASP.NET Core 集成:从入门到精通
本文详细介绍了如何在ASP.NET Core中集成GraphQL,包括安装必要的NuGet包、创建GraphQL Schema、配置GraphQL服务等步骤。同时,文章还探讨了常见问题及其解决方法,如处理复杂查询、错误处理、性能优化和实现认证授权等,旨在帮助开发者构建灵活且高效的API。
24 3
|
2月前
mcr.microsoft.com/dotnet/core/aspnet:2.1安装libgdiplus
mcr.microsoft.com/dotnet/core/aspnet:2.1安装libgdiplus
34 1
|
3月前
|
开发框架 监控 前端开发
在 ASP.NET Core Web API 中使用操作筛选器统一处理通用操作
【9月更文挑战第27天】操作筛选器是ASP.NET Core MVC和Web API中的一种过滤器,可在操作方法执行前后运行代码,适用于日志记录、性能监控和验证等场景。通过实现`IActionFilter`接口的`OnActionExecuting`和`OnActionExecuted`方法,可以统一处理日志、验证及异常。创建并注册自定义筛选器类,能提升代码的可维护性和复用性。
|
2月前
|
开发框架 JavaScript 前端开发
一个适用于 ASP.NET Core 的轻量级插件框架
一个适用于 ASP.NET Core 的轻量级插件框架
|
3月前
|
开发框架 前端开发 JavaScript
ASP.NET MVC 教程
ASP.NET 是一个使用 HTML、CSS、JavaScript 和服务器脚本创建网页和网站的开发框架。
50 7
|
3月前
|
存储 开发框架 前端开发
ASP.NET MVC 迅速集成 SignalR
ASP.NET MVC 迅速集成 SignalR
79 0
|
4月前
|
开发框架 前端开发 .NET
ASP.NET MVC WebApi 接口返回 JOSN 日期格式化 date format
ASP.NET MVC WebApi 接口返回 JOSN 日期格式化 date format
57 0