EF Core 2.1变化
EF Core 2.1随.NET Core 2.1一起发布，本篇文章总结一下EF Core的新增功能，先从简单的开始说。
一、延迟加载
延迟加载不用介绍了吧，直接看一下怎样配置吧。EF Core 2.1默认是不允许延迟加载的，想要使用这个特性必须调用UseLazyLoadingProxies方法，这个扩展方法在 Microsoft.EntityFrameworkCore.Proxies 包中。
在Startup中配置：
public void ConfigureServices(IServiceCollection services)
{
services.AddDbContext<TestContext>(options =>
{
options.UseLazyLoadingProxies().UseSqlServer("yourConnectionString");
});
}
也可在DbContext中重写OnConfiguring方法中配置：
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
optionsBuilder.UseLazyLoadingProxies().UseSqlServer("yourConnectionString");
}
配置好后在实体类中对应的属性上加上 virtual 关键字就OK，用法和EF6没区别。除了加 virtual 标记外，EF Core 2.1还可以通过 ILazyLoader 类型的对象来实现延迟加载，实现如下：
public class Person
{
public Person() { }
public Person(ILazyLoader lazyLoader)
{
LazyLoader = lazyLoader;
}
public int Id { get; set; }
public string Name { get; set; }
public int Age { get; set; }
private ILazyLoader LazyLoader { get; set; }
private ICollection<Child> _children;
public virtual ICollection<Child> Children
{
get => LazyLoader?.Load(this, ref _children);
set => _children = value;
}
}
ILazyLoader在 Microsoft.EntityFrameworkCore.Abstractions 程序集中。按照官方文档所述，除了注入 ILazyLoader 类型使用LazyLoader外还可以注入Action<object,string>类型来实现LazyLoader，但我尝试的时候报错，如果有尝试成功的希望能在留言区里留言，多谢。
二、支持GroupBy
这个特性就不多说了，使用方法和EF6没区别。
三、支持TransactionScope
这个特性也和EF6一样，终于可以随时随地使用事务了。
四、Data Seeding
这个功能是用来初始化数据的，在进行数据库迁移时，EF会往数据库中插入一些数据，实现如下：
public class PersonConfig : IEntityTypeConfiguration<Person>
{
public void Configure(EntityTypeBuilder<Person> builder)
{
builder.HasData(new Person[]
{
new Person
{
Id = 1,
Name ="张三",
Age = 30
}
});
}
}
使用EntityTypeBuilder下的HasData就可以实现该功能。但令人感到奇怪的是，就算Id是自增长的EF也会要求Id有值！而且也不支持同时插入子表的数据。
public class PersonConfig : IEntityTypeConfiguration<Person>
{
public void Configure(EntityTypeBuilder<Person> builder)
{
builder.HasData(new Person[]
{
new Person
{
Id = 1,
Name ="张三",
Age = 30,
Children = new List<Child>
{
new Child
{
Id = 1,
Name = "小张三",
Age = 5,
PersonId = 1
},
new Child
{
Id = 2,
Name = "小小张三",
Age = 1,
PersonId = 1
}
}
}
});
}
}
上面的代码，在进行数据迁移时，Children的数据不会插入到数据库中，不知道以后是否会支持关联属性的数据导入。
五、值转换
这个功能简单来说就是将属性的类型转换成数据库中的类型(比如枚举转换成字符串)，实例中可以这样写：
public class Person
{
public Person() { }
public Person(ILazyLoader lazyLoader)
{
LazyLoader = lazyLoader;
}
public int Id { get; set; }
public string Name { get; set; }
public int Age { get; set; }
public Gender Gender { get; set; }
private ILazyLoader LazyLoader { get; set; }
private ICollection<Child> _children;
public virtual ICollection<Child> Children
{
get => LazyLoader?.Load(this, ref _children);
set => _children = value;
}
}
public enum Gender
{
男,
女
}
然后再配置一下：
public class PersonConfig : IEntityTypeConfiguration<Person>
{
public void Configure(EntityTypeBuilder<Person> builder)
{
builder.Property(p => p.Gender).HasConversion(v => v.ToString(), v => (Gender)Enum.Parse(typeof(Gender), v)).IsRequired().HasMaxLength(2);
}
}
这里有个问题比较奇怪，我在配置类中加上这段配置并在HasData中给Gender赋值，使用Migration的时候发现如果不加 IsRequired 他居然不给我把Gender的数据给导入到数据库里面！！！
除了基本的枚举转字符串以外，EF Core还提供如下的转换类：
| BoolToZeroOneConverter | 将布尔值转换为0或1 |
| BoolToStringConverter | 将布尔值转换为字符串(Y或N) |
| BoolToTwoValuesConverter | 将布尔值转换为指定的两个值(没搞明白干嘛用的) |
| BytesToStringConverter | 将字节数组转换为Base64编码的字符串 |
| CastingConverter | 从一种类型转换到另一种类型(可以被C#互相转换的类型) |
| CharToStringConverter | char转为string |
| DateTimeOffsetToBinaryConverter | DateTimeOffset转为二进制的64位的值 |
| DateTimeOffsetToBytesConverter | DateTimeOffset转为字节数组 |
| DateTimeOffsetToStringConverter | DateTimeOffset转为字符串 |
| DateTimeToBinaryConverter | DateTime转为带有DateTimeKind的64位的值 |
| DateTimeToStringConverter | DateTime转为字符串 |
| DateTimeToTicksConverter | DateTime转为ticks |
| EnumToNumberConverter | 枚举转数字 |
| EnumToStringConverter | 枚举转字符串 |
| GuidToBytesConverter | Guid转字节数组 |
| GuidToStringConverter | Guid转字符串 |
| NumberToBytesConverter | 数字转字节数组 |
| NumberToStringConverter | 数字转字符串 |
| StringToBytesConverter | 字符串转字节数组 |
| TimeSpanToStringConverter | TimeSpan转字符串 |
| TimeSpanToTicksConverter | TimeSpan转ticks |
上面的这些对象的使用方式如下：
var converter = new EnumToStringConverter<Person>(); builder.Property(p => p.Gender).HasConversion(converter);
除了这种方式外，EF Core也支持直接指定类型，如：
builder.Property(p => p.Gender).HasConversion(string);
需要注意的是，不能将null进行转换，一个属性只能对应一个列做转换。
六、Query Types
这个功能用来查询数据库视图的。先创建个实体类：
public class Family
{
public int ParentId { get; set; }
public string ParentName { get; set; }
public int ParentAge { get; set; }
public int ChildId { get; set; }
public string ChildName { get; set; }
public int ChildAge { get; set; }
}
根据实体类在数据库中创建视图就行(貌似Migration不支持创建视图)，SQL我就不写了。然后创建个继承自 IQueryTypeConfiguration<> 的配置类，代码如下：
public class FamilyConfig : IQueryTypeConfiguration<Family>
{
public void Configure(QueryTypeBuilder<Family> builder)
{
builder.ToView("Family_View");
}
}
DbContext中使用 DbQuery<Family> 类型增加一个属性，运行下看看结果：
根据官方文档所述，该功能只能查询，不能增删改，不具有状态跟踪，不能包含具体查询类型的导航属性(既然不能有导航属性为啥这里有个lazyLoader...)。
本文总结的都是我认为有用的功能，EF Core 2.1新增的其他功能可以到移步至官方文档：https://docs.microsoft.com/en-us/ef/core/what-is-new/ef-core-2.1
最后补充一个扩展方法，功能和EF6的AddFromAssembly方法相同。
private static bool IsIEntityTypeConfigurationType(Type typeIntf)
{
return typeIntf.IsInterface && typeIntf.IsGenericType && typeIntf.GetGenericTypeDefinition() == typeof(IEntityTypeConfiguration<>);
}
public static void ApplyConfigurationsFromAssembly(this ModelBuilder modelBuilder, Assembly assembly)
{
//筛选出继承自IEntityTypeConfiguration的类型
IEnumerable<Type> types = assembly.GetTypes().Where(t => !t.IsAbstract && t.GetInterfaces().Any(it => IsIEntityTypeConfigurationType(it)));
Type typeModelBuilder = modelBuilder.GetType();
MethodInfo methodNonGenericApplyConfiguration = typeModelBuilder.GetMethods()
.Where(m => m.IsGenericMethod && m.Name == nameof(ModelBuilder.ApplyConfiguration) && m.GetParameters().Any(s => s.ParameterType.GetGenericTypeDefinition() == typeof(IEntityTypeConfiguration<>))).First();
foreach (var type in types)
{
object entityTypeConfig = Activator.CreateInstance(type);
//获取实体的类型
Type typeEntity = type.GetInterfaces().First(t => IsIEntityTypeConfigurationType(t)).GenericTypeArguments[0];
//通过MakeGenericMethod转换为泛型方法
MethodInfo methodApplyConfiguration = methodNonGenericApplyConfiguration.MakeGenericMethod(typeEntity);
methodApplyConfiguration.Invoke(modelBuilder, new[] { entityTypeConfig });
}
}
以上代码根据RuPeng.EFCore.Ext组件修改，该组件暂时不支持EF Core 2.1，GitHub已提交pr，不知道杨老师啥时候更新下。
