数据注解

添加System.ComponentModel.DataAnnotations命名空间的using语句

EF 支持的完整注释列表为：

---

• KeyAttribute
• StringLengthAttribute
• MaxLengthAttribute
• ConcurrencyCheckAttribute
• RequiredAttribute
• TimestampAttribute
• ComplexTypeAttribute
• ColumnAttribute
• TableAttribute
• InversePropertyAttribute
• ForeignKeyAttribute
• DatabaseGeneratedAttribute
• NotMappedAttribute

Key/ForeignKey

---

Key

场景一：
Instructor实体和OfficeAssignment实体之间有“一对零”或“一对一”的关系。办公室只和讲师之间存在关系，因此其主键也是其Instructor实体的外键。但是实体框架不会自动将InstructorID识别为实体的主键，因为该命名不遵循实体框架约定。因此，我们使用Key特性来标记该属性为实体的主键。
场景二：
如果实体没有它自己的主键，但您想将属性名命名为类名-ID或ID以外的不同的名称，您同样可以使用Key特性。默认情况下实体框架将键视为非数据库生成的，因为该列用来标识关系。

ForeignKey

当两个实体之间存在有“一对零”或“一对一”关系时，实体框架无法自动辨认出那一端的关系是主体，那一端是依赖。一对一关系在每个类中使用导航属性来引用其他类。
ForeignKey特性可以应用于要建立关系的依赖类。
如果您省略ForeignKey特性，当您尝试创建迁移时系统会出现一个无法确定实体间关系的错误。

示例：

using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace ContosoUniversity.Models
{
    public class OfficeAssignment
    {
        [Key]
        [ForeignKey("Instructor")]
        public int InstructorID { get; set; }
        public string Location { get; set; }
        public virtual Instructor Instructor { get; set; }
    }
}

 

public class Instructor
{
   public int ID { get; set; }
   public string LastName { get; set; }
   public string FirstMidName { get; set; }
   public DateTime HireDate { get; set; }
   public virtual ICollection<Course> Courses { get; set; }
   public virtual OfficeAssignment OfficeAssignment { get; set; }
}

 

导航属性：

Instructor实体有一个可为空的OfficeAssignment导航属性(因为可能有讲师没有分配办公室)，
并且OfficeAssignment实体有一个不可为空的Instuctor导航属性(因为一个办公室不可能在没有讲师的情况下分配出去--InstructorID是不可为空的)。
当Instructor实体具有OfficeAssignment实体关联的时候，每个实体在导航属性中都会有另一个实体的引用。
您可以把一个Required特性添加给Instructor导航属性来指明必须有相关的讲师，但您不需要这样做。因为InstructorId外键(同样也是表的主键)是不可为null的。

外键属性：

课程实体有一个DepartmentID外键属性，用来指向相关的Department实体，它有一个Department导航属性。当一个关联实体有一个导航属性时，实体框架不需要您添加外键属性到您的实体模型，实体框架在需要时会在数据库中自动创建外键。但在实体模型中拥有一个外键会让更新更简单、高效。例如，当您读取一个Course实体进行编辑，如果您选择不加载Department实体，那Department实体是空的。所以当您更新Course实体时，您必须先取得该实体关联的Department实体。如果在数据模型中包含了外键DepartmentID，您就不需要在更新前先取得Department实体。

 

 

DataType

---

示例：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.ComponentModel.DataAnnotations;

namespace ContosoUniversity.Models
{
    public class Student
    {
        public int ID { get; set; }
        public string LastName { get; set; }
        public string FirstMidName { get; set; }
        [DataType(DataType.Date)]
        [DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)] 
        public DateTime EnrollmentDate { get; set; }

        public virtual ICollection<Enrollment> Enrollments { get; set; }
    }
}

DataType枚举

https://msdn.microsoft.com/zh-cn/library/system.componentmodel.dataannotations.datatype%28v=vs.110%29.aspx

成员名称

描述

CreditCard

表示信用卡号码。

Currency

表示货币值。

Custom

表示自定义的数据类型。

Date

表示日期值。

DateTime

表示某个具体时间，以日期和当天的时间表示。

Duration

表示对象存在的一段连续时间。

EmailAddress

表示电子邮件地址。

Html

表示一个 HTML 文件。

ImageUrl

表示图像的 URL。

MultilineText

表示多行文本。

Password

表示密码值。

PhoneNumber

表示电话号码值。

PostalCode

表示邮政代码。

Text

表示所显示的文本。

Time

表示时间值。

Upload

表示文件上载数据类型。

Url

表示 URL 值。