容器添加映射路径增加映射

转载

JAVA小侠影 2024-07-23 13:18:48

Code First Fluent API通常情况下是在DbContext的派生类中重写OnModelCreating方法。

1.配置Length

Length用来描述数组的长度，当前包括string和Byte数组。

默认约定：Code First对string或byte数组的默认长度约定是max。注意：Sql Server Compact中默认最大数组长度是4000。

重写约定：使用HasMaxLength(nn)，参数为可空整数。

1:  Property(t => t.Name).HasMaxLength(50);

另外关于Length的Fluent API还有下面2个：

IsFixedLength()，配置属性为固定长度。

IsMaxLength()，配置属性为数据库提供程序允许的最大长度。

2.配置Data Type

Data Type表示将.NET类型映射到的数据库的数据类型。

默认约定：列的数据类型由使用的数据库提供程序决定。以SQL Server为例：String->nvarchar(max),Integer->int,Byte[]->varbinary(max),Boolean->bit。

重写约定：使用HasColumnType(“xxx”)，下面列子的Photo是byte[]类型，配置映射到image数据类型：

1:  Property(t => t.Photo).HasColumnType("image");

3.配置允许为空和不允许为空

默认约定：主键属性不允许为空，引用类型（String,array）允许为空，值类型（所有的数字类型，Datetime,bool,char）不允许为空，可空的值类型Nullable<T>允许为空。

重写约定：使用IsRequired()配置不允许为空，使用IsOptional()配置允许为空。下面配置Name属性为不为空：

1:   Property(t => t.Name).IsRequired();

4.配置属性到指定列

默认约定：映射到与属性名相同的列。

重写约定：使用Property(t=>t.属性名).HasColumnName(“xxx”)。下面配置Name映射到DepartmentName：

1:  Property(t => t.Name).HasColumnName("DepartmentName");

5.配置主键

默认约定：(1)属性名为ID或Id的默认为主键

(2)类名+ID或类名+Id默认为主键（其中ID或Id的优先级大于类名+ID或类名+Id）

重写约定：使用HasKey(t=>t.属性名)。下面将BlogId配置为主键：

1:   HasKey(t => t.BlogId);

6.配置组合主键

下面的例子将DepartmentId和Name属性组合作为Department类型的主键：

1:  HasKey(t => new { t.DepartmentId, t.Name });

7.配置Database-Generated

默认约定：整型键：Identity。

重写约定：使用Property(t => t.属性名).HasDatabaseGeneratedOption(DatabaseGeneratedOption)。

DatabaseGeneratedOption枚举包括三个成员：

(1) None：数据库不生成值

(2) Identity：当插入行时，数据库生成值

(3) Computed：当插入或更新行时，数据库生成值

整型默认是Identity，数据库生成值，自动增长，如果不想数据库自动生成值，使用DatabaseGeneratedOption.None。

Guid类型作为主键时，要显示配置为DatabaseGeneratedOption.Identity。

8.配置TimeStamp/RowVersion的乐观并发

默认约定：这个没有默认约定。

配置：使用Property(t=>t.属性名).IsRowVersion()

1:  Property(t => t.RowVersion).IsRowVersion();

9.不配置TimeStamp的乐观并发

有些数据库不支持RowVersion类型，但是又想对数据库的一个或多个字段并发检查，这时可以使用Property(t=>t.属性名).IsConcurrencyToken(),下面的例子将SocialSecurityNumber配置为并发检查。

1:  Property(t => t.SocialSecurityNumber).IsConcurrencyToken();

10.配置String属性是否支持Unicode内容

默认约定：默认string是Unicode（在SQL Server中是nvarchar）的。

重写约定：下面的例子使用IsUnicode()方法将Name属性配置为varchar类型的。

1:  Property(t => t.Name).IsUnicode(false);

11.配置小数的精度和小数位数

默认约定：小数是(18,2)

配置：使用Property(t=>t.属性名).HasPrecision(n,n)

1:  public decimal MilesFromNearestAirport { get; set; }

12.复杂类型

默认复杂类型有以下规则：

(1) 复杂类型没有主键属性
(2) 复杂类型只能包含原始属性。
(3)在其他类中使用复杂类型时，必须表示为非集合类型。

使用DbModelBuilder.ComplexType方法显示配置为复杂类型：

1:  modelBuilder.ComplexType<Address>();

13.嵌套的复杂类型

嵌套的复杂类型只需显示配置外层，内层自动继承复杂类型的约定。

14.配置复杂类型的属性

配置复杂类型的属性和配置实体属性一样，具体参考下面的实例。

二、配置属性实例

下面直接给出代码，代码上都有注释。注：下面的实体主要是为了演示用

1:      //实体

2:      public class Trip

3:      {

4:          public Guid Identifier { get; set; }

5:          public DateTime StartDate { get; set; }

6:          public DateTime EndDate { get; set; }

7:          public decimal CostUSD { get; set; }

8:          public string Description { get; set; }

9:          public byte[] RowVersion { get; set; }

10:      }

11:

12:      //复杂类型

13:      public class Address

14:      {

15:          public int AddressId { get; set; }

16:          public string StreetAddress { get; set; }

17:          public string City { get; set; }

18:          public string State { get; set; }

19:          public string ZipCode { get; set; }

20:      }

21:

22:      //复杂类型

23:      public class PersonalInfo

24:      {

25:          public Measurement Weight { get; set; }

26:          public Measurement Height { get; set; }

27:          public string DietryRestrictions { get; set; }

28:      }

29:

30:      //复杂类型

31:      public class Measurement

32:      {

33:          public decimal Reading { get; set; }

34:          public string Units { get; set; }

35:      }

36:

37:      //实体

38:      public class Person

39:      {

40:          public Person()

41:          {

42:              Address = new Address();

43:              Info = new PersonalInfo()

44:              {

45:                  Weight = new Measurement(),

46:                  Height = new Measurement()

47:              };

48:          }

49:

50:          public int PersonId { get; set; }

51:          public int SocialSecurityNumber { get; set; }

52:          public string FirstName { get; set; }

53:          public string LastName { get; set; }

54:          public Address Address { get; set; }

55:          public byte[] Photo { get; set; }

56:          public PersonalInfo Info { get; set; }

57:          public byte[] RowVersion { get; set; }

58:      }

59:

60:      //对实体Trip的配置，继承自EntityTypeConfiguration<T>

61:      public class TripConfiguration : EntityTypeConfiguration<Trip>

62:      {

63:          public TripConfiguration()

64:          {

65:              //配置Identifier映射到TripId列，并设为主键，且默认值为newid()

66:              HasKey(t => t.Identifier).Property(t => t.Identifier).HasDatabaseGeneratedOption(DatabaseGeneratedOption.Identity).HasColumnName("TripId");

67:              //配置CostUSD的精度为20，小数位数为3

68:              Property(t => t.CostUSD).HasPrecision(20, 3);

69:              //配置Description的长度为500

70:              Property(t => t.Description).HasMaxLength(500);

71:              //配置RowVersion乐观并发检查

72:              Property(t => t.RowVersion).IsRowVersion();

73:          }

74:      }

75:

76:      //对实体Person的配置，继承自EntityTypeConfiguration<T>

77:      public class PersonConfiguration : EntityTypeConfiguration<Person>

78:      {

79:          public PersonConfiguration()

80:          {

81:              //配置SocialSecurityNumber不允许为空且乐观并发检查

82:              Property(t => t.SocialSecurityNumber).IsRequired().IsConcurrencyToken();

83:              //配置FirstName不允许为空

84:              Property(t => t.FirstName).IsRequired();

85:              //配置LastName不允许为空

86:              Property(t => t.LastName).IsRequired();

87:              //配置Photo映射到数据库的数据类型为image

88:              Property(t => t.Photo).HasColumnType("image");

89:              //配置RowVersion乐观并发检查

90:              Property(t => t.RowVersion).IsRowVersion();

91:          }

92:      }

93:

94:      //对复杂类型Address的配置，继承自ComplexTypeConfiguration<T>

95:      public class AddressConfiguration : ComplexTypeConfiguration<Address>

96:      {

97:          public AddressConfiguration()

98:          {

99:              //配置AddressId映射到AddressId列

100:              Property(t => t.AddressId).HasColumnName("AddressId");

101:              //配置StreetAddress长度为100并映射到StreetAddrress列

102:              Property(t => t.StreetAddress).HasMaxLength(100).HasColumnName("StreetAddress");

103:              //配置State长度为50并映射到State列

104:              Property(t => t.State).HasMaxLength(50).HasColumnName("State");

105:              //配置City长度为50并映射到City列

106:              Property(t => t.City).HasMaxLength(50).HasColumnName("City");

107:              //配置ZipCode映射到ZipCode列，不支持Unicode内容，并设为固定长度为6

108:              Property(t => t.ZipCode).IsUnicode(false).IsFixedLength().HasMaxLength(6).HasColumnName("ZipCode");

109:          }

110:      }

111:

112:      //对复杂类型PersonalInfo的配置，继承自ComplexTypeConfiguration<T>

113:      public class PersonalInfoConfiguration : ComplexTypeConfiguration<PersonalInfo>

114:      {

115:          public PersonalInfoConfiguration()

116:          {

117:              //配置DietryRestrictions长度为100

118:              Property(t => t.DietryRestrictions).HasMaxLength(100);

119:          }

120:      }

121:

122:      public class BreakAwayContext : DbContext

123:      {

124:          public DbSet<Trip> Trips { get; set; }

125:          public DbSet<Person> People { get; set; }

126:

127:          protected override void OnModelCreating(DbModelBuilder modelBuilder)

128:          {

129:              //注册配置

130:              modelBuilder.Configurations.Add(new TripConfiguration());

131:              modelBuilder.Configurations.Add(new PersonConfiguration());

132:              modelBuilder.Configurations.Add(new AddressConfiguration());

133:              modelBuilder.Configurations.Add(new PersonalInfoConfiguration());

134:              base.OnModelCreating(modelBuilder);

135:          }

136:      }

最后生成的数据库结构，如下图所示：

Trips表

People表

二、 System.ComponentModel.DataAnnotations

DataAnnotations提供了若干个属性用于设置实体类字段，Data Annotations在功能上是Fluent API的子集，Data Annotations在功能上是Fluent API的子集。

1.Association（指定某个实体成员表示某种数据关系，如外键关系）

2.AttributeUsage（指定另一特性类的用法。此类不能被继承）

3.BindableType（指定类型是否通常用于绑定）、Compare（提供比较两个属性的属性）

4.ComplexType

跨一组类描述域实体，然后将这些类分层以描述一个完整实体的情况并不少见。例如，您可以向模型中添加一个名为 BlogDetails 的类

容器添加映射路径增加映射_主键_03

容器添加映射路径增加映射_主键_04

请注意，BlogDetails 没有任何键属性类型。在域驱动的设计中，BlogDetails 称为值对象。实体框架将值对象称为复杂类型。复杂类型不能自行跟踪。但是 BlogDetails 作为 Blog 类中的一个属性，将作为 Blog 对象的一部分被跟踪。为了让 Code First 认识到这一点，您必须将 BlogDetails 类标记为 ComplexType。

现在，您可以在Blog 类中添加一个属性来表示该博客的 BlogDetails。

容器添加映射路径增加映射_Code_05

在数据库中，Blog表将包含该博客的所有属性，包括在其 BlogDetail 属性中所含的属性。默认情况下，每个属性都将添加复杂类型名称前缀 BlogDetail。

另外，有趣的是，虽然DateCreated 属性在类中定义为不可为空的 DateTime，但相关数据库字段是可为空的。如果想影响数据库架构，则必须使用 Required 注释。

4.ConcurrencyCheck （指定某属性将参与开放式并发检查）请注意，BlogDetails没有任何键属性类型。在域驱动的设计中，BlogDetails称为值对象。实体框架将值对象称为复杂类型。复杂类型不能自行跟踪。

但是BlogDetails作为Blog类中的一个属性，将作为Blog对象的一部分被跟踪。为了让Code First认识到这一点，您必须将BlogDetails类标记为ComplexType。

5.CreditCardAttribute（指定数据字段值是信用卡号码）

6.CustomValidationAttribute（指定自定义的验证方法来验证属性或类的实例）

6.DataType（指定要与数据字段关联的附加类型的名称）

7.Display（提供一个通用特性，使您可以为实体分部类的类型和成员指定可本地化的字符串）

8.DisplayColumn（将所引用的表中显示的列指定为外键列）

9.DisplayFormat（指定 ASP.NET 动态数据如何显示数据字段以及如何设置数据字段的格式）

10.Editable（指示数据字段是否可编辑）

11.EmailAddress（确认一电子邮件地址）

12.EnumDataType（使 .NET Framework 枚举能够映射到数据列）

13.FileExtensions（文件扩展名验证）

14.FilterUIHint

表示一个特性，该特性用于指定列的筛选行为

15.Key

该属性将映射到数据库中的主键列

当使用Code First的数据库生成功能，则Blog表将具有名为PrimaryTrackingKey的主键列，该列默认情况下还定义为Identity。

16.MaxLength和MinLength

指定属性中允许的数组或字符串数据的最大\小长度

容器添加映射路径增加映射_容器添加映射路径_06

MaxLength 注释将通过把属性长度设置为 10 来影响数据库。MinLength属性不会对数据库产生影响。

17.MetadataType

指定要与数据模型类关联的元数据类

18.NotMapped

Code First 约定指示具有受支持数据类型的每个属性都要在数据库中有表示。但在您的应用程序中并不总是如此。例如，您可以在 Blog 类中使用一个属性来基于 Title 和BloggerName 字段创建代码。该属性可以动态创建，无需存储。您可以使用 NotMapped 注释来标记不映射到数据库的所有属性，如下面的 BlogCode 属性。

容器添加映射路径增加映射_容器添加映射路径_07

19.Phone（使用电话号码的正则表达式，指定数据字段值是一个格式良好的电话号码）

20.Range（指定数据字段值的数值范围约束）

21.RegularExpression（指定 ASP.NET 动态数据中的数据字段值必须与指定的正则表达式匹配）

22.Required

Required 注释告诉 EF 某一个特定属性是必需的

容器添加映射路径增加映射_容器添加映射路径_08

Required 特性将使被映射的属性不可为空来影响生成的数据库。请注意，Title 字段已经更改为“not null”。

23.ScaffoldColumn（指定类或数据列是否使用基架）

24.ScaffoldTable（指定类或数据表是否使用基架）

25.StringLength（指定数据字段中允许的最小和最大字符长度）

26.Timestamp（将列的数据类型指定为行版本）

27.UIHint（指定动态数据用来显示数据字段的模板或用户控件）

28.Url（提供 URL 验证）

三、结束语

本篇文章的内容比较简单，就是一些配置，了解理论知识并熟悉运用是关键。

点击查看《Entity Framework实例详解》系列的其他文章。

如果遇到问题，可以访问Entity Framework社区，网址是www.ef-community.com