Code First :使用Entity. Framework编程(3) ----转发 收藏
第三章
对属性使用约定和配置
在第2章,对Code First的约定以及如何通过配置覆写默认约定行为进行了大致的介绍。学习了如何使用Data Annotations进行配置,也学习了如何使用Fluent API作出相同的配置,并对两者进行了对比。
在本章乃至以后几章里,将深入各种用于配置模型的领域。对每个主题会看到Code First如何通过默认规则进行工作,也会学到如何通过Data Annotations和Fluent API来覆写这些规则。前已指出,在Fluent API中可以实现的很多配置在Data Annotations无法实现。我们会在适当的时机指出这些差异。
本章专注于对类中属性的配置,以观察默认规则和配置对数据库列的影响。你将会学习到诸如如何控制字符串长度,byte 数组,数值的精度等方面的知识。你也可以学到键属性以及所谓的“开放式并发属性”。最后,您还可以学到有关Code First检测一个属性是否是复杂类型(aka值类型),如果Code First无法从您的域类中推断出复杂类型时,我们将都会您如何对Code First提供帮助以识别复杂类型。
在Code First中使用属性
在第2章里,您已经看到一些应用于字符串属性的规则和配置选项,在进入新的选择我们快速回顾一下。
Length
字长
Convention
默认规则
max (type specified by database)
max(类型由数据库指定)
Data Annotation
MinLength(nn)
MaxLength(nn)
StringLength(nn)
Fluent
Entity<T>.Property(t=>t.PropertyName).HasMaxLength(nn)
字长用于描述数组的长度。包括对字符串和byte数组。
Code First的默认规则string 或者byte数组的长度应为最大。根据不同的数据库类型确定在数据库最终的类型。对SQL Server而言,string 会生成nvarchar(max),而byte数组会生成varbinary(max).
你可以覆写默认长度来设置在数据库中的实际字长。长度的最大值会在EF框架将更新数据存入数据库之前进行验证。如果使用Data Annotation来配置,还可以为数组配置MinLength(最小长度)特性。最小长度特性也会得到EF验证API的验证,但不会影响数据库。
数据类型
Convention
默认规则
The default column data type is determined by the database provider you are using. For SQL Server some example default data types are:
默认的列数据类型由数据库决定,对SQL Server而言如下:
String : nvarchar(max)
Integer:int
Byte Array:varbinary(max)
Boolen:bit
Data Annotation
Column(TypeName="XXX")
Fluent
Entity<T>.Property(t=>t.PropertyName).HasColumnType("XXX")
第2章,您已经看到了几个如何映射.Net类型到数据库数据类型的例子。Destination和Lodging类包含有整型,字符串,Byte数组,布尔型变量。Code First通知数据库选择合适的数据类型匹配每一列。由于使用的是SQL Server数据库,因此分别映射到nvarchar(max), int, varbinary(max)和bit类型。
根据您选择的配置当然也可以指定到基他类型。例如,将字符串映射到数据库的int数据类型,运行时DbModelBuilder就会抛出一个错误告知映射非法,然后会给出如何进行纠正的细节指示。
可空性和必需项配置
Convention
默认规则
Key Properties : not null in database
键属性:在数据库中为非空
Reference Types (String, arrays): null in the database
引用类型(String,数组):在数据库中可空
Value Types (all numeric types, DateTime, bool, char) : not null in database
值类型(所有数字类型,日期,布尔,字符):在数据库为非空
Nullable<T> Value Types : null in database
Nullable<T>值类型(可空类型):在数据库可空
Data Annotation
Required
Fluent
Entity<T>.Property(t=>t.PropertyName).IsRequired
默认规则约定确保非可空的.Net类型要映射到数据库的非可空字段,除此以外,任何键属性都只能映射到非可空数据库字段。
如果你使用.Net的泛型Nullable<T>指定一个值类型(如int)为可空,将会映射到数据库的一个可空字段。
在第2章您已看到如何使用配置指定一个属性为必须项。使用Data Annotation的Required标记和Fluent的IsRequired属性都可强制Lodging.Name属性为必须项。在保存数据到数据库之前,EF运行时会对必须属性进行验证;如果属性没有赋值就会抛出一个异常。另一个效果是,数据库相应字段为非空。
映射键
Convention
默认规则
Properties named Id
属性名为Id
Properties named [TypeName] + Id
属性名为[类型名]+Id
Data Annotation
Key
Fluent
Entity<T>.HasKey(t=>t.PropertyName
EF框架要求每个实体都有一个键。这个键用于上下文以保持每个独立对象的跟踪。键是唯一的而且经常由数据库生成。Code First默认规则作出了同样的预设。
回忆一下由Destination和Lodging类生成的数据库,DestinationId和LodgingId的整型字段都被标记为主键和非空字段。如果进一步观察二者的列属性,你会发现这些字段是自增长的标识字段,如图3-1所示,这是默认规则将整型量作为主键来管理。
大多数情况下,数据库中的主键不是int就是GUID类型,尽管任意类型都可以作为键属性。数据库中的主键会是多个表的组成字段,类似地,一个实体的键也是某个类中的多个属性之一。在本节结束的时候,你会看到如何配置复合键。
Code First默认规则对不合规键属性的响应
如果在我们的类中我们意指的键碰巧满足Code First默认规则,那么一切顺利。但是如果不满足规则呢?
我们向模型添加一个新类,Trip,见代码3-1.Trip类没有任何满足实体键默认规则的属性,但我们的意图是Identifier属性应该作为键。
Example 3-1. The Trip class without an obvious key property
public class Trip
{
public Guid Identifier { get; set; }
public DateTime StartDate { get; set; }
public DateTime EndDate { get; set; }
public decimal CostUSD { get; set; }
}
伴随这个新类,我们需要在BrakAwayContext中添加一个DbSet<Trip>数据集:
public DbSet<Trip> Trips { get; set; }
我们再次运行程序,在尝试从类中创建模型时DbModel Builder抛出一个异常:
在模型生成过程中检测到一个或多个验证错误:
System.Data.Edm.EdmEntityType: :
实体类型"Trip"还没有定义key。请为这个实体类型定义Key.
由于没有找到期望的默认Key属性(Id或TripId),Code First无法继续创建模型。需要明确的是,类型(GUID)与这个问题无关。如前所述,您可以使用任何的原始类型作为键。
使用Data Annotations配置Key
Data Annotation标识一个键只需要简单的一个Key.Key特性位于System.ComponentModel.DataAnnotations.dll,由于它已经被添加到了.Net4之中,也被其他API所使用(如ASP.Net MVC使用的Key).如果你的项目尚未包含此程序集的引用,你就不能添加它。对这个特定的特性不需要引用EntityFramwork.dll。
[Key]
public Guid Identifier { get; set; }
在Flurent API中使用HasKey来配置Key属性
使用Fluent API来配置Key属性与前面几个Fluent配置不同。这一配置直接添加到实体上。为了配置一个key,你需要使用HasKey方法,如代码3-2。
Example 3-2. The HasKey Fluent configuration in OnModelCreating
modelBuilder.Entity<Trip>().HasKey(t => t.Identifier)
如果将代码配置进EntityTypeConfiguration类中,正如你在第2章学到的,应该开始于HasKey或This.HasKey(代码3-3)
Example 3-3. HasKey inside of an EntityTypeConfiguration class
HasKey(t => t.Identifier)
配置数据库生成的属性
Convention
默认规则
Integer keys:Identity
整型键值:标识列
Data Annotation
DatabaseGenerated(DatabaseGeneratedOption)
Fluent
Entity<T>.Property(t=>t.PropertyName)
.HasDatabaseGeneratedOption(DatabaseGeneratedOption)
在前面部分里,你已经看到默认情况整型键值会被EF框架生成标识字段,由数据库生成值。而我们自己创建的Guid型的键值怎么办?Guid需要特殊的处置,包含在DatabaseGenerated配置。
为了展示,我们添加一个新方法,InsertTrip(代码3-4)到控制台程序,然后在主模型进行调用。
Example 3-4. The InsertTrip method
private static void InsertTrip()
{
var trip = new Trip
{
CostUSD = 800,
StartDate = new DateTime(2011, 9, 1),
EndDate = new DateTime(2011, 9, 14)
};
using (var context = new BreakAwayContext())
{
context.Trips.Add(trip);
context.SaveChanges();
}
}
运行程序会导致数据库卸载并增加新的Trips表后重新创建,如图3-2.Identifier是主键,唯一标识,非空列。
回到本章前面的内容,你知道值类型默认是required。在此也会看到同样的效果,StartDate,EndDtat和CostUSD属性都是值类型,默认情况下,在数据库也都是非空字段。
然后在新行中我们看到Guid值被填充为很多个0.如图3-3
数据库和EF框架都不知道我们想让他们之一为新添加的Trips生成一个新的Guid。由于这个属性没有一个生成新Guid的逻辑方法,就会默认以0值填入。
如果你尝试以同样的值插入另一个记录,数据库会抛出一个错误,因为期待一个唯一值。当然可以配置数据库自动生成一个新的Guid(通过设置默认值为newid()。不管你在数据库中手动操作还希望CodeFirst插入此逻辑,你必须让Code First知道数据库将要处理Guid.
解决方案是让Code First 知道数据库将要生成这个键值通过使用另一个annotation:DatabaseGenerated.这一配置有三个选项—None,Identity和Computed.我们想要Identifier字段被标识为Identity,才能确保数据库在加入新行时自动生成标识字段的值,正如整型类型的键值自动生成一样。
使用Data Annotations配置数据库-生成选项
修改类代码告诉Code First让数据库生成一个唯一的键值:
[Key,DatabaseGenerated(DatabaseGeneratedOption.Identity)]
public Guid Identifier { get; set; }
当键字段为整数时,Code First默认选择DatabaseGeneratedOption.Identity。而对Guid,你需要显示进行配置。这是唯一一种可以通过Identify来配置Code First的数据类型。如果映射到一现有的数据库,任何在插入数据可生成值的列都可以标识为Identify.
再次运行程序,如图3-4,输出了新生成的标识。
你可能对查看SQL语句感兴趣,代码3-5显示的EF框架发送给数据库的INSERT语句,其中要求数据库为Idenfifier属性生成Guid值
Example 3-5. SQL for inserting a new Trip
declare @generated_keys table([Identifier] uniqueidentifier)
insert [dbo].[Trips]([StartDate], [EndDate], [CostUSD])
output inserted.[Identifier] into @generated_keys
values (@0, @1, @2)
select t.[Identifier]
from @generated_keys as g
join [dbo].[Trips] as t on g.[Identifier] = t.[Identifier]
where @@ROWCOUNT > 0',
N'@0 datetime2(7),@1 datetime2(7),@2 decimal(18,2)',
@0='2011-09-01 00:00:00',@1='2011-09-14 00:00:00',@2=800.00
DatabaseGeneratedOption还有两个枚举值:None和Coumputed。下面就有一个示例证明None是有用的。代码3-6显示了另一个新类,Person,SocialSecurityNumber属性已经被配置为此类的键属性。
Example 3-6. Person class with unconventional key property
using System.ComponentModel.DataAnnotations;
namespace Model
{
public class Person
{
[Key]
public int SocialSecurityNumber { get; set; }
public string FirstName { get; set; }
public string LastName { get; set; }
}
}
记得要在BreakAwayContext类中添加DbSet<Person>
public DbSet<Person> People { get; set; }
最后,将一个新方法,InsertPerson(见代码3-7)添加到控制台程序中,在Main方法中调用这个方法,就会向数据库中添加一个新的person。
Example 3-7. InsertPerson method
private static void InsertPerson()
{
var person = new Person
{
FirstName = "Rowan",
LastName = "Miller",
SocialSecurityNumber = 12345678
};
using (var context = new BreakAwayContext())
{
context.People.Add(person);
context.SaveChanges();
}
}
再次运行程序,让我们再看看数据库新添加的一行,如图3-5.
SocialSecurityNumber 的值是 1, 不是12345678.为什么?由于Code First根据key是一个整型这个事实告知数据库这是一个标识字段,因此在INSERT语句中EF框架没有提供正确的SocialSecurityNumber 的值,而是让数据库自行生成。从而在SaveChanges完成后查看 person实例中SocialSecurityNumber 的值,此值已经被更新为数据库生成的值,1.
为修正这一点,我们需要添加一些配置覆写默认标识规则,在这种情况下,DatabaseGeneratedOption.Identity是不对的,应该用None:
[Key, DatabaseGenerated(DatabaseGeneratedOption.None)]
public int SocialSecurityNumber { get; set; }
然后再运行程序,如图3-6,数据库正确插入了有关数据。
DatabaseGeneratedOption.Computed用于指定一个映射到数据库的字段是通过计算得到的。例如,如果有一个FullName字段在People表中,是用一个公式将FirstName和LastName组合起来得到的,你就应该让EF框架知道以便其不会尝试存储数据到此列中。你不能指定一个公式用来计算Code First中列的值,因此当映射到一个现存的数据库中你只能使用Computed。要不然,在试图创建数据库时如果遇到Computed配置,数据库引擎就会抛出运行时异常。
使用Fluent API来配置数据库生成选项
DatabaseGeneratedOption可以配置为一种特殊的属性,你可以将配置附加HasKey后面,如:
modelBuilder.Entity<Trip>()
.HasKey(t => t.Identifier)
.Property(t => t.Identifier)
.HasDatabaseGeneratedOption(DatabaseGeneratedOption.Identity);
或者创建一个独立的语句:
modelBuilder.Entity<Person>()
.HasKey(p => t.SocialSecurityNumber);
modelBuilder.Entity<Person>()
.Property(p => p.SocialSecurityNumber)
.HasDatabaseGeneratedOption(DatabaseGeneratedOption.None);
你会注意到DatabaseGeneratedOption枚举位于System.ComponentModel.DataAnnotations名称空间,在EntityFramework.dll中。需要在context类的文件头部添加using引用。
为开放式并发环境配置时间戳或行版本字段
Convention
默认规则
None
无
Data Annotation
TimeStamp
Fluent
Entity<T>.Property(t=>t.PropertyName).IsRowVersion()
EF框架从第一版本开始就支持开放式并发环境。Programming Entity Framework这本书的第二版在第23章深入探讨了开放式并发。在这里我我们教你如何配置类映射到RowVersion(或称作TimeStamp,时间戳)字段,同时通知EF框架在进行更新或删除数据库操作时使用这些字段进行并发检查。
使用Code First你需要指定一个字段使用开放式并发检查,与映射到数据库的类型无关,或者你可以进一步指定并发的字段映射到一个TimeStamp字段。
一个类只能有一个属性可以配置为TimeStamp特性。
R
RowVersion和TimeStamp是两个具有相同类型的项。Sql Server使用TimeStamp,而其他数据库使用更恰当的名称为RowVersion.d SQL Server2008中,timestamp数据类型也调整为rowversion,但是大多数工具(如Sql Server Management Studio,vs等)仍然显示为timestamp.
Code First的默认规则与TimeStamp字段
默认情况下,Code First并不识别时间戳属性,因此没有默认约定行为,获得此行为必须配置此属性。
使用Data Annotations配置时间戳
并非任何属性都可以映射到一个timestamp数据库类型。必须是byte数组才可以。配置过程很简单,将TimeStamp特性加到Trip和Personal类中的下列属性中。
[Timestamp]
public byte[] RowVersion { get; set; }
然后运行控制台程序,确保InserTrip和InsertPerson方法都在Main方法中进行调用。在数据库中你会看到新生成的RowVersion列(图3-7),类型为非可空timestamp类型。
任何时候行内数据被修改时数据库都会自动为此属性创建新值。但TimeStamp不仅影响数据库的映射,还会导致属性被EF框架视作并发的令牌。如果你使用EDMX文件,这就等同于设置了一个属性的ConcurrencyMode(并发模式)。EF框架在执行插入、更新或删除数据库时,就会考虑并发字段,返回每个INSERT和UPDATE更新数据库的值,并传回到每个UPDATE和DELETE的相关属性的原始位置。
例3-8显示了当执行InsertPerson方法后保存设置时的SQL语句:
Example 3-8. INSERT combined with SELECT to return new RowVersion
exec sp_executesql N
'insert [dbo].[People]([SocialSecurityNumber], [FirstName], [LastName])
values (@0, @1, @2)
select [RowVersion]
from [dbo].[People]
where @@ROWCOUNT > 0 and [SocialSecurityNumber] = @0',
N'@0 int,@1 nvarchar(max) ,@2 nvarchar(max) ',@0=12345678,@1=N'Rowan',@2=N'Miller'
EF框架不仅通知数据库执行插入,而且还请求返回RowVersion的值。一旦属性被标记为并发,EF就总会这样做,即使它并不是一个timestamp类型数据。对更新和删除语句更是如此,因为在这会有并发检查产生。我们添加一个新的方法,UpdatePerson到程序中,见代码3-9
Example 3-9. The UpdateTrip method
private static void UpdateTrip()
{
using (var context = new BreakAwayContext())
{
var trip = context.Trips.FirstOrDefault();
trip.CostUSD = 750;
context.SaveChanges();
}
}
代码3-10显示了当调用UpdatePerson时的SQL语句:
Example 3-10. UPDATE that filters on original RowVersion and returns new RowVersion
exec sp_executesql N'update [dbo].[Trips]
set [CostUSD] = @0
where (([Identifier] = @1) and ([RowVersion] = @2))
select [RowVersion]
from [dbo].[Trips]
where @@ROWCOUNT > 0 and [Identifier] = @1',
N'@0 decimal(18,2),@1 uniqueidentifier,@2 binary(8)',
@0=750.00,@1='D1086EFE-5C5B-405D-9F09-688981BB5B41',@2=0x0000000000001773
注意谓词Where用于定位trip的语句被更新—过滤器包括了Identifier和Rowversion两个参数。如果另外的人更改了行程就会被我们的方法检索到,由于RowVersion已经更改,将不会再有行匹配过滤器。更新就会失败,EF框架会抛出OptimisticConcurrencyException的异常。
使用Fluent API配置TimeStamp/RowVersion
Fluent 使用RowVersion来配置,要指定一个RowVersion属性,需要将IsRowVersion()方法附加到属性上。
使用DbModelBuilder,需要对属性作如下配置:
modelBuilder.Entity<Person>()
.Property(p => p.RowVersion).IsRowVersion();
在EnityTypeConfiguration<T>类中配置如下:
Property(p=>p.RowVersion).IsRowVersion();
配置并发非时间戳字段
Convention
默认规则
None
无
Data Annotation
ConcurrencyCheck
Fluent
Entity<T>.Property(t=>t.PropertyName).IsConcurrencyToken()
一个不太常见的方式是并发检查是通过字段为非行版本类型进行的。例如,许多数据库可能并没有行版本数据类型。因此你不能指定一个行版本属性,但你仍需要对一个或多个数据库字段进行并发检查。
Person类当前使用属性SocialSecurityNumber作为其标识键。设想类使用了PersionId属性作为标识键而将SocialSecurityNumber简单地视作整型数据而不作为标识跟踪。在这种情况下,你可能想有一种方法避免在SocialSecurityNum ber进行改变时的冲突,因为在美国,每个公民的社会保险号码是唯一的。因此,如果一个一个用户编辑了一个人的记录,可能更改的FirstName的拼写,但同时,另外的人想更改此人的社会保险号码,前者在尝试存储更改时就会遇到一个冲突。指定SocialSecurityNumber属性为一个并发检查字段将提供这种检查(避免这种事情发生)。
使用Data Annotations配置开放式并发
代码3-11显示了修改的类为SocialSecurityNumber配置并发检查
Example 3-11. Modified Person class with a ConcurrencyCheck
public class Person
{
public int PersonId { get; set; }
[ConcurrencyCheck]
public int SocialSecurityNumber { get; set; }
public string FirstName { get; set; }
public string LastName { get; set; }
}
例3-12显示了一个方法试图更新一个Person.如果调用这个方法,就需要先调用InsertPerson以确保数据库内存在一个Person数据。
Example 3-12. The UpdatePerson method
private static void UpdatePerson()
{
using (var context = new BreakAwayContext())
{
var person = context.People.FirstOrDefault();
person.FirstName = "Rowena";
context.SaveChanges();
}
}
正如您在Trip.RowVersion字段中看到的(代码3-10),当一个更新或删除请求发送以数据库时,SLQ语句(见代码3-13)不仅查找匹配的Key(PersonId),还要匹配原始并发字段值(SocialSecurityNumber).
Example 3-13. SQL providing concurrency checking on SocialSecurityNumber
exec sp_executesql N'update [dbo].[People]
set [FirstName] = @0
where (([PersonId] = @1) and ([SocialSecurityNumber] = @2))
',N'@0 nvarchar(max) ,@1 int,@2 int',@0=N'Rowena',@1=1,@2=12345678
如果匹配没有发现(也就是说SocialSecurityNumber已经在数据库中变更了),更新失败抛出OptimisticConcurrencyException异常。
使用Fluent API的开放式并发配置
Fluent API使用IsConcurrencyToken方法配置并发,并应用于属性。如代码3-14所示
Example 3-14. Configuring concurrency checking fluently
public class PersonConfiguration : EntityTypeConfiguration<Person>
{
public PersonConfiguration()
{
Property(p => p.SocialSecurityNumber).IsConcurrencyToken();
}
}
我们为Person提供其自己的配置类,也就是这个新类。不要忘记在OnModelCreating方法中将PersonConfiguration添加到modelBuilder.Configurations集合里。
映射到非-Unicode数据库类型
Convention
默认规则
All strings map to Unicode-encoded database types
所有的字符串都映射到Unicode数据库类型
Data Annotation
不可用
Fluent
Entity<T>.Property(t=>t.PropertyName).IsUnicode(boolean)
默认情况下,Code First会将所有字符串都映射到数据库中的Unicode字符串类型。
你可以使用IsUnicod方法指定一个字符串是否映射到数据库Unicode字符串类型。下列代码添加到LodgingConfiguation中告诉Code First不要将Owner属性作为Unicode 类型:
Property(l=>l.Owner).IsUnicode(false);
对Decimal固定有效位数和小数位数的影响
Convention
默认规则
Decimals are 18, 2
Data Annotation
不可用
Fluent
Entity<T>.Property(t=>t.PropertyName).HasPrecision(n,n)
固定有效位数(一个数字中数的位数)和小数位数(小数点右侧的位数)可以使用Fluent API进行配置,而不能用Data Annotations配置。
为了观察其如何工作,我们向Lodging 类中添加一个新的decmial属性:MilesFromNearestAirport:
public decimal MilesFromNearestAirport { get; set; }
默认设置
默认情况下,固定有效位数为18,小数位为2,如图3-8所示。
使用Flurent API,可以对固定有效位和小数位进行配置,使用的是HasPrecison方法。即使默认值之一是想要设置的的,也需要将两个值都指定:
Property(l => l.MilesFromNearestAirport).HasPrecision(8, 1);
图3-9显示了MilesFromNearestAirport有效位和小数位的更改情况。
在Code First使用复杂类型
EF框架从第一版开始就支持复杂类型。复杂类型也可视作值类型(?)可以作为附加属性添加到其他类。复杂类型与实体类型的区别在于复杂类型没有其自己的键。它是依赖于其"宿主"类型跟踪变化 和持久化。
一个没有Key属性的类型,并且作为属性映射到一个或多个类型中,Code First就会将其视作为复杂类型。Code First将预设复杂类型的属性出现在宿主类型映射到数据库的表中。
在People表中如何将Person中的Address包含进来,将Address的属性都映射到People表中?可以直接将所有相关属性都纳入Person类中,见代码3-15:
Example 3-15. Individual properties representing an address in Person
public class Person
{
public int PersonId { get; set; }
public int SocialSecurityNumber { get; set; }
public string FirstName { get; set; }
public string LastName { get; set; }
public string StreetAddress { get; set; }
public string City { get; set; }
public string State { get; set; }
public string ZipCode { get; set; }
}
但在你的模型中如果使用Address类作为分割类,就可以简化Person类,如代码3-16所示:
Example 3-16. Address type as a property of Person
public class Address
{
public int AddressId { get; set; }
public string StreetAddress { get; set; }
public string City { get; set; }
public string State { get; set; }
public string ZipCode { get; set; }
}
public class Person
{
public int PersonId { get; set; }
public int SocialSecurityNumber { get; set; }
public string FirstName { get; set; }
public string LastName { get; set; }
public Address Address { get; set; }
}
但是如果这样分割,使用默认规则,会产生一个单独的表:Addresses。而我们目标是让People表中拥有一系列地址字段。如果Adress是一个复杂类型就可以达到这个目的。如果你有其他表中也包含相同的属性,你也可以在那些类中使用Address复杂类型。
定义默认复杂类型
最方便的方法将Address转化为复杂类型是移除AddressId 属性。现在注释掉它:
// public int AddressId { get; set; }
在重新运行程序之前,你需要考虑InsertPerson方法(代码3-7)之前 Address是否存在。因为Address属性没有处理将会成为null值,将会造成SaveChanges抛出DbUpdateException异常。现在可以向代码中插入一个新的Person,并且在Person类中实例化一个新的Address。
Example 3-17. Instantiating the Address property in the constructor of the Person class
public class Person
{
public Person()
{
Address = new Address();
}
//…
}
除了复杂类型不能有Key以外,Code First中还有两条规则用于检测复杂类型是否满足要求。复杂类型在应用于其他类时只能包含原始属性,只能被用作为非集合类型。换句话说,如果想要Person类中有一个List<Address>或其他Address类型的集合类型属性,Address不能作为复杂类型。
复杂类型的默认规则
复杂类型无Key属性
复杂类型只包含原始属性
用作其他类的属性时,属性必须是一个单一实例,不能用于集合类型
运行程序后,图3-10显示了Address字段成为了People表的一部分。Code First认定Address是一个复杂类型,在新模型生成得到响应:
注意Address 字段的命名:HostPropertyName_Property。这是Code First 的默认设置。第5章,你就会学到如何为复杂属性配置列名。
配置非默认复杂类型
如果要使用复杂类型,必须要遵循这些规则吗?可能您想要有一个AddressId属性,尽管你知道一个单独的地址实例不会变更,也不需要EF框架对其跟踪。
如果我们添加AddressId属性重新运行程序,Code First不能推断出你的意图,然后会创建一个单独的Addersses表,并建立与People表的主外键关系。你可以显示地配置复杂类型来修正。
使用Data Annotations指定复杂类型
Data Annotation提供了ComplexType特性应用于类上。
Example 3-18. Address with AddressId reinstated and a ComplexType configuration
[ComplexType]
public class Address
{
public int AddressId { get; set; }
public string StreetAddress { get; set; }
public string City { get; set; }
public string State { get; set; }
public string ZipCode { get; set; }
}
使用这种方式,再次运行程序,模型将重建,最终的数据库架构再一次同图3-10一致,另外附加了一个新的int字段,命名为Address_AddressId.
使用Fluent API指定复杂类型
为了通过Fluent API向Code First指明一个类型为复杂类型,你必须使用DbModelBuilder.ComplexType 方法。
modelBuilder.ComplexType<Address>();
代码3-19显示了对OnModelCreating方法的修改:
Example 3-19. Specifying a complex type fluently
protected override void OnModelCreating(DbModelBuilder modelBuilder)
{
modelBuilder.Configurations.Add(new DestinationConfiguration());
modelBuilder.Configurations.Add(new LodgingConfiguration());
modelBuilder.Configurations.Add(new PersonConfiguration());
modelBuilder.Configurations.Add(new TripConfiguration());
modelBuilder.ComplexType<Address>();
}
本modelBuilder的配置故意将新增加的配置代码放在后面。那些直接通过内建在OmodelCreating方法内部建立的modelBuilder类的实例,称为内联配置,必须将这些代码写在添加的配置类集合的后面。
处理更多的杂乱的复杂类型
回想默认配置的复杂类型规定类型只能包含原始类型。如果你的复杂类型不符合这一规范,必须进行配置,这里有一些例子。
我们创建了两个新类,PersonalInfo和Measuremet,见代码3-20. PersonalInfo包含有两个Measurement属性。注意到在两个类都没有标识属性。我们的意图是两个类都成为复杂类型。PersonalInfo复杂类型使用Measurment复杂类型,这就是所谓的嵌套复杂类型。
Example 3-20. New classes: PersonalInfo and Measurement
public class PersonalInfo
{
public Measurement Weight { get; set; }
public Measurement Height { get; set; }
public string DietryRestrictions { get; set; }
}
public class Measurement
{
public decimal Reading { get; set; }
public string Units { get; set; }
}
当我们向Person类中添加新的PersonInfo属性后:
public PersonalInfo Info { get; set; }
也需要添加一些逻辑到Person的构造器,用具体实例说明这些属性:
public Person()
{
Address = new Address();
Info = new PersonalInfo
{
Weight = new Measurement(),
Height = new Measurement()
};
}
如果此时继续运行程序,Model builder会抛出异常:
实体类"PersonInfo"没有定义键。请为此实体类定义键。
Code First 并没有将PersonalInfo识虽为复杂类型。原因是我们打破了规则:复杂类型必须只包含原生类型。在PersonalInfo类中有两个Measurement类型的属性。由于这是非原生类型,规则不能将PersonalInfo作为复杂类型。
如果添加ComplexType配置到PersonalInfo类,Code First就能够将属性建立到模型中。你不必配置Measurement类,因为它遵循复杂类的规则。
配置复杂类型的属性
Code First将复杂类型属性与其他类型以相同的方式处理,你可以用Data Annotations或Fluently来配置。
使用Data Annotations来配置复杂类型
与Code First默认命名列类似:ComplexTypeName_PropertyName(见图3-10)。你可以应用Data Annotations在复杂类型上,正如你在其他类上使用的那样。例3-21使用了一个你熟悉的特性标记,MaxLength,去影响 Address类型的中的属性。
Example 3-21. Configuring the StreetAddress property of the Address
[ComplexType]
public class Address
{
public int AddressId { get; set; }
[MaxLength(150)]
public string StreetAddress { get; set; }
public string City { get; set; }
public string State { get; set; }
public string ZipCode { get; set; }
}
Figure 3-11 shows the People table of the database with the modified Address_StreetAddress field. You can also see the Address_AddressId field that came from reinstating AddressId and the fields added as a result of the PersonalInfo complex type and its Measurement subtype.
图3-11显示了数据库的People表,其Address_streetAddress字段已经被修改.你也可以看到Address_AddressId字段来自于AddressId,作为结果,新添加的了PersonalInfo复杂类型和它的Measurement子类型.
第5章,我们重新检视复杂类型的列名,然后你会学习如何通过配置调整列名.
使用Fluent API来配置复杂类型
使用Fluent API有两种方法配置复杂类型属性.你可以开始于宿主实体也可以开始于复杂类型本身.根据EF构架团队的报告,后者是更好的配置方式.MaxLength属于这一类.当我们在第5章讨论列名时,我们会从Person实体中进行配置,以期对Person映射到字段的名字产生影响.
Model builder能够识别复杂类和实体类的差异.
如果你想直接从DbModelBuilder配置,必须开始于Compex<T>方法,而不是一直在用的Entity<T>方法.代码3-22展示了直接在OnCreatingModel中的ModelBuilder实例配置复杂类型.
Example 3-22. Configuring a property of the Address complex type
modelBuilder.ComplexType<Address>()
.Property(p => p.StreetAddress).HasMaxLength(150);
如果你更喜欢封装配置,你需要继承自ComplexTypeConfiguation类而不是EntityTypeConfigration,如代码3-23.
Example 3-23. Configuring the length of StreetAddress in the Address ComplexType
public class AddressConfiguration :
ComplexTypeConfiguration<Address>
{
public AddressConfiguration()
{
Property(a => a.StreetAddress).HasMaxLength(150);
}
}
你还要确保在模型中添加AddressConfiguration:
modelBuilder.Configurations.Add(new AddressConfiguration());
小结
I在本章中你已经看到很多Code First创建的预设模型,这些模型都是基于你自己的类创建的.Strings在SQL Server中变成nvarchar(max).数字的固定位数设置为18位(可以确保你可以跟踪1024的数据)和2位小数.这些及其他默认值在很广泛的场合中很有关,你也可以根据需要通过应用配置指定位数.你已经学到如何确保EF框架知道如何将值设定为timestamps或至少是一个并发字段.你已经开始接触到复杂类型,这些类型没有键,只有它们是其他类的属性时才能用到.
Code First的约定在大量通用场景都发挥了很好的作用,但通过你的配置来覆写这些约定还可以控制如何由EF框架来管理你的类.
Code First :使用Entity. Framework编程(3) ----转发 收藏的更多相关文章
- Code First :使用Entity. Framework编程(1) ----转发 收藏
这个是在学习EF CodeFirst时发现的,对于初学者还是不错的.果断转发,方便自己以后查阅和学习. 对于学习Code First 这个教程讲解的还是很详细. 第一章:欢迎来到Code First ...
- Code First :使用Entity. Framework编程(7) ----转发 收藏
第7章 高级概念 The Code First modeling functionality that you have seen so far should be enough to get you ...
- Code First :使用Entity. Framework编程(8) ----转发 收藏
第8章 Code First将走向哪里? So far, this book has covered all of the Code First components that reached the ...
- Code First :使用Entity. Framework编程(6) ----转发 收藏
Chapter6 Controlling Database Location,Creation Process, and Seed Data 第6章 控制数据库位置,创建过程和种子数据 In prev ...
- Code First :使用Entity. Framework编程(5) ----转发 收藏
第五章 对数据库映射使用默认规则与配置 到目前为止我们已经领略了Code First的默认规则与配置对属性.类间关系的影响.在这两个领域内,Code First不仅影响模型也影响数据库.在这一章,你将 ...
- Code First :使用Entity. Framework编程(2) ----转发 收藏
第二章:Code First概览 如果你使用第一.二版的EF框架工作过,你会回想起书中的业务案例:Break Away Geek Adventures, 简称BAGA.BAGA共享了很多像我们这样的奇 ...
- Code First :使用Entity. Framework编程(4) ----转发 收藏
第4章 对关系使用默认规则与配置 在第3章,你已经掌握了默认规则与配置对属性以及其在数据库映射的字段的影响.在本章,我们把焦点放在类之间的关系上面.这包括类在内存如何关联,还有数据库中的外键维持等.你 ...
- Code First配合Entity Framework Power Tools Beta 4使用
基于现有数据库生成POCO数据类和数据库上下文需要借助Visual Studio一个扩展插件-- Entity Framework Power Tools(一个Code First反向工程工具).只要 ...
- 【译著】Code First :使用Entity. Framework编程(5)
第五章 对数据库映射使用默认规则与配置 到目前为止我们已经领略了Code First的默认规则与配置对属性.类间关系的影响.在这两个领域内,Code First不仅影响模型也影响数据库.在这一章,你将 ...
随机推荐
- Spring.NET的AOP怎么玩
之前公司一直不让使用第三方组件,因此AOP方面的组建一直不能使用,很多面向切面的应用只能通过自己写一些GenericMethod的泛型方法来解决,有一些呆板.由于公司已经开始全面转Java,因此架构组 ...
- ssh(sturts2_spring_hibernate) 框架搭建之struts2
一.struts2完整流程的逻辑(整体的概述) 首先,用户在地址栏中输入你的项目访问路径,然后这个请求会发送到服务器,之后服务器发现在web.xml中配置了一个filter过滤器,并且这个过滤器需要对 ...
- Kruskal算法(二)之 C++详解
本章是克鲁斯卡尔算法的C++实现. 目录 1. 最小生成树 2. 克鲁斯卡尔算法介绍 3. 克鲁斯卡尔算法图解 4. 克鲁斯卡尔算法分析 5. 克鲁斯卡尔算法的代码说明 6. 克鲁斯卡尔算法的源码 转 ...
- 使用webpack打包ThinkPHP的资源文件
使用webpack打包ThinkPHP的资源文件 利用自己的空余时间一直在维护http://www.wx2share.com这个小网站,全是一个人在弄,由于只租得起虚拟空间,所以后台采用了简单方便的T ...
- 百度,淘宝,腾讯三大巨头HTML页面规范分解
[兼容html5方案] 百度贴吧,百度图片的实现 <!--[if lt IE 9]> <script> (function(){ var tags = ['header','f ...
- webpack打包压缩工具的使用方法
具体使用方法参考来源http://www.cnblogs.com/Leo_wl/p/4793722.html 必须注意的地方: 一.webpack在nodejs环境下运行 二,每个目录下都必须有一个w ...
- GoodReader跨域访问HT for Web手册
最近下载了GoodReader App,发现GoodReader中打开的页面不仅支持WebGL,同时还允许跨域访问资源,以前不少HT for Web手册的例子需要Web服务器发布的方式才能访问,否则需 ...
- C# DllImport用法和路径问题
DllImport是System.Runtime.InteropServices命名空间下的一个属性类,其功能是提供从非托管DLL导出的函数的必要调用信息. DllImport属性应用于方法,要 ...
- 常用的一些SQL语句整理,也许有你想要的。
本篇文章是对一些常用的sql语句进行了总结与分析,需要的朋友参考下,也许会有你需要的. 1.SQL行列转换 问题:假设有张学生成绩表(tb)如下:姓名 课程 分数张三 语文 74张三 数学 83张三 ...
- 认识IoC
第一次接触IoC是我在学习MVP框架的时候,搭建一个MVP框架需要用到IoC,那时候就以为IoC就是依赖注入,但在后来的逐步了解中发现那个只是它的别名而已.IoC全称应该是Inversion of C ...