EF Core Data Annotations怎么用 EF Core数据注解使用方法-C#.Net教程-PHP中文网

EF Core Data Annotations怎么用 EF Core数据注解使用方法

月夜之吻

发布： 2025-12-23 13:15:10

原创

576人浏览过

EF Core数据注解是用于实体类和属性的特性，支持表名、主键、字段约束、关系及忽略字段等配置；适合中小型项目，高级功能需配合Fluent API使用。

ef core data annotations怎么用 ef core数据注解使用方法

EF Core 数据注解（Data Annotations）是一组写在实体类和属性上的特性（Attributes），让 EF Core 在运行时自动理解如何把你的 C# 类映射到数据库表结构、字段约束、关系等。它简单直观，适合中小型项目或快速原型开发。

基础配置：表名与主键

用 [Table] 指定实体映射的数据库表名，可选带 Schema：

[Table("users", Schema = "auth")]
public class User
{
    [Key]
    public int Id { get; set; }
    public string Name { get; set; }
}

登录后复制

[Table("users")] → 映射到 users 表；加 Schema = "auth" 则生成在 auth.users 下
[Key] 标记主键字段，EF Core 默认识别 Id 或 ClassNameId，但显式标注更清晰可靠

字段级控制：长度、空值与类型

对字符串等属性加验证和数据库约束注解：

public class Product
{
    [Key]
    public int Id { get; set; }
<pre class="brush:php;toolbar:false;">[Required]           // NOT NULL
[MaxLength(100)]     // nvarchar(100)
public string Name { get; set; }

[Column(TypeName = "decimal(18,2)")]
public decimal Price { get; set; }

[StringLength(500)]
public string Description { get; set; }

登录后复制

}

[Required] 强制非空，生成 NOT NULL 列
[MaxLength(n)] 和 [StringLength(n)] 效果类似，都限制最大长度；前者更常用，后者兼容 ASP.NET 验证
[Column(TypeName = "...")] 精确控制数据库列类型，比如 varchar、datetime2、decimal(18,2)

关系与外键配置

用 [ForeignKey] 明确声明外键属性，并配合导航属性使用：

Studio Global

Studio Global AI 是一个内容生成工具，帮助用户客制化生成风格和内容，以合理价格提供无限生成，希望将 AI 带给全世界所有人。

405

查看详情

public class Order
{
    public int Id { get; set; }
    public int CustomerId { get; set; }
<pre class="brush:php;toolbar:false;">[ForeignKey("CustomerId")]
public Customer Customer { get; set; }

登录后复制

}

public class Customer { public int Id { get; set; } public string Name { get; set; } public List Orders { get; set; } }

[ForeignKey("CustomerId")] 告诉 EF Core：Customer 导航属性由 CustomerId 字段驱动
若属性名符合约定（如 CustomerId 对应 Customer），可省略该注解；但显式写上更易维护
注意：[ForeignKey] 参数是外键属性名（字符串），不是导航属性名

忽略字段与只读计算属性

用 [NotMapped] 排除不存入数据库的字段：

public class User
{
    public int Id { get; set; }
    public string Email { get; set; }
<pre class="brush:php;toolbar:false;">[NotMapped]
public string DisplayName => $"User-{Email.Split('@')[0]}";

[NotMapped]
public DateTime LocalCreatedAt { get; set; }

登录后复制

}