Entity Framework 4.1 DbContext使用记之三——如何玩转实体的属性值?

之前的两篇有关EF4.1的文章反响不错,感谢大家的支持!想体验EF4.1的新功能?RTW版本已经发布啦http://www.microsoft.com/downloads/en/details.aspx?FamilyID=b41c728e-9b4f-4331-a1a8-537d16c6acdf&displaylang=en   

Entity Framework 4.1 DbContext使用记之一——如何查找实体? DbSet.Find函数的使用与实现

Entity Framework 4.1 DbContext使用记之二——如何玩转本地实体? DbSet.Local属性的使用与实现

 

今天的主题是如何玩转EF4.1中实体的属性。实体的属性其实是我们使用EF来访问和修改实体的关键。在EF以前版本中,如果我们一般会直接访问对象的属性,比如得到PersonID大于100的所有Person实体的ID和Name:

using (var context = new MyContext())
{
    var people 
= context.People.Where(p => p.PersonID > 100);
    
for (var p in people)
    {
        Console.WriteLine(
"ID: {0}, Name:{1}", p.PersonID, p.Name);
    }

但是如果要得到ObjectContext所track的实体属性的OriginalValues(原始值)和CurrentValues(当前值),则不是很方便。

 

而在EF4.1中,由于我们可以使用DbContext.Entry()DbContext.Entry<T>()来得到DbEntityEntryDbEntityEntry<T>对象。通过DbEntityEntry (DbEntityEntry<T>)的OriginalValues和CurrentValues属性,我们可以方便地得到相应的属性集合(DbPropertyValues)。通过DbEntityEntry (DbEntityEntry<T>)的Property(Property<T>)方法得到DbPropertyEntryDbPropertyEntry<T>)之后,我们也能通过相应的OriginalValue和CurrentValue属性得到单个属性的原始值和当前值。感觉有点绕?看看下面的这些例子应该就简单明了多了! 

using (var context = new MyDbContext())
{
    
// 有关Find方法,请看EF4.1系列博文一
    var person = context.People.Find(1);

    
// 得到Person.Name属性的当前值
    string currentName = context.Entry(person).Property(p => p.Name).CurrentValue;

    
// 设置Person.Name属性的当前值
    context.Entry(person).Property(p => p.Name).CurrentValue = "Michael";

    
// 通过string值"Name"来获得DbPropertyEntry,而非通过Lambda Expression
    object currentName2 = context.Entry(person).Property("Name").CurrentValue;
}

 

再来看看如何得到实体的所有属性的OriginalValue(原始值),CurrentValue(当前值)和DatabaseValue(数据库值)吧:

using (var context = new MyDbContext())
{
    var person 
= context.People.Find(1);

    
// 改变对应的实体的Name属性
    person.Name = "Michael";

    
// 改变对应属性的数据库值
    context.Database.ExecuteSqlCommand("update Person set Name = 'Lingzhi' where PersonID = 1");

    
// 输出对应实体所有属性的当前值,原始值和数据库值
    Console.WriteLine("Current values:");
    PrintValues(context.Entry(person).CurrentValues);

    Console.WriteLine(
"\nOriginal values:");
    PrintValues(context.Entry(person).OriginalValues);

    Console.WriteLine(
"\nDatabase values:");
    PrintValues(context.Entry(person).GetDatabaseValues());
}

这里用到的PrintValues函数实现如下:

public void PrintValues(DbPropertyValues values)
{
    
foreach (var propertyName in values.PropertyNames)
    {
        Console.WriteLine(
"Property {0} has value {1}",
                          propertyName, values[propertyName]);
    }
}

这里具体的输出大家就当小练习吧,呵呵。

 

下面再为大家介绍两个我个人认为比较cool的小功能:

1) 设置多层的复杂类型的属性。

例如,Person实体含有Address复杂类型属性(Complex - type),Address又含有City这一string类型属性,那么我们可以这样来获得City这一属性的当前值:

// 使用Lambda Expression
string city = context.Entry(person).Property(p => p.Address.City).CurrentValue;

// 使用string类型的属性表达
object city = context.Entry(person).Property("Address.City").CurrentValue;

这里层次的次数其实没有限制,可以一直点下去的。:)   EF的内部实现也是使用递归调用的方式,之后会有详细的介绍。 

 

2) 克隆含有实体属性当期值,原始值或数据库值的对象。

我们可以使用DbPropertyValues.ToObject()方法来克隆将DbPropertyValues中相应的属性和值变成对象。

using (var context = new MyDbContext())
{
    var person 
= context.People.Find(1);
    var clonedPerson 
= context.Entry(person).GetDatabaseValues().ToObject();

这里克隆到的对象不是实体类,也不被DbContext所跟踪。但这样的对象在处理数据库并发等问题时会很有用。


又到了探寻以上介绍的功能的内部实现的时候啦!我们还是照例使用.NET Reflector来查看EntityFramework.dll。 大家可以打开Reflector和我一起来做个简单的分析。


首先是从DbContext.Entry方法得到DbEntityEntry。Entry方法通过调用DbEntityEntry internal的构造函数DbEntityEntry(InternalEntityEntry internalEntityEntry)来创建一个DbEntityEntry对象。这里的InternalEntityEntry又是通过DbContext.InternalContext和先前传入Entry函数的实体对象来生成的。

public InternalEntityEntry(InternalContext internalContext, object entity)
{
    
this._internalContext = internalContext;
    
this._entity = entity;
    
    // ObjectContextTypeCache应该是EF内部保存的静态的类型缓存,用于查找实体类型
    this._entityType = ObjectContextTypeCache.GetObjectType(this._entity.GetType());
    
    // InternalContext.GetStateEntry内部则调用了ObjectStateManager.TryGetObjectStateEntry方法
    this._stateEntry = this._internalContext.GetStateEntry(entity);
    
if (this._stateEntry == null)
    {
        
this._internalContext.Set(this._entityType).InternalSet.Initialize();
    }
}

 

下面来看看DbEntityEntry.CurrentValues/OriginalValues。CurrentValues和OriginalValues属性都是DbPropertyValues类型的。DbPropertyValues可以被理解为对于一个实体或复杂类型所有属性信息的集合。我们通过PropertyNames属性拿到其所有属性的名字,通过GetValue或SetValues方法得到或设置属性值。还能通过我们之前讨论的ToObject方法来克隆一个有用与对应实体或复杂类型对象一样属性值的对象。演示一下如何使用DbPropertyValues.SetValuesF方法:

using (var context = new MyDbContext())
{
    var person 
= context.People.Find(1);
    var person1 
= new Person { PersonID = 1, Name = "Michael" };
    var person2 
= new Person { PersonID = 1, Name = "Lingzhi" };

    var entry 
= context.Entry(person);
    
    
// 这里直接将拥有相应属性值的实体对象直接赋给SetValues方法,直接对person实体的CurrentValues和OriginalValues进行赋值
    entry.CurrentValues.SetValues(person1);
    entry.OriginalValues.SetValues(person2);
}

 

这里SetValues内部首先调用了DbHelpers.GetPropertyGetters方法。DbHelpers是System.Data.Entity.Internal命名空间下Internal的类,包含了许多静态的辅助方法。这里的GetPropertyGetters顾名思义就是得到属性Getter方法delegate的集合,内部当然是通过PropertyInfo以及.NET Reflection来完成。有了这个Getter方法delegate的集合,我们就能方便地拿到传入SetValues方法的对象的所有属性值了,最后则按照所得到的属性值来进行赋值。

 

接着我们再来看看如何从DbEntityEntry.Property得到DbPropertyEntry。我们可以传递两种property的表达方式给DbEntityEntry.Property方法:1) Lambda Expression   2) string类型的property表示。先来说说1),在将Lambda Expression解析为对应property时,EF使用了辅助静态方法DbHelpers.ParsePropertySelector,ParsePropertySelector又调用了另一静态辅助方法DbHelpers.TryParsePath。具体算法在这里就不做深入解析,简单说这个TryParsePath方法就是递归地将Lambda Expression所表示的property层层深入地获取到,例如像这样的Lambda Expression:person => person.Address.City最后就变为"Address.City"。在解析完毕之后,ParsePropertySelector其实也是将Lambda Expression变成了string类型的property表示。自然,EF此时就调用了第二个接受string类型的property表示的DbEntityEntry.Property重载。DbEntityEntry.Property(string)在经过了一系列其他的内部调用之后,到了System.Data.Entity.Internal.InternalEntityEntry.Property(...):

private InternalPropertyEntry Property(InternalPropertyEntry parentProperty, string propertyName, IList<string> properties, Type requestedType, bool requireComplex)
{
    
bool flag = properties.Count > 1;
    Type type 
= flag ? typeof(object) : requestedType;
    Type declaringType 
= (parentProperty != null? parentProperty.EntryMetadata.ElementType : this.EntityType;
    PropertyEntryMetadata metadata 
= this.ValidateAndGetPropertyMetadata(properties[0], declaringType, type);
    
if ((metadata == null|| ((flag || requireComplex) && !metadata.IsComplex))
    {
        
if (flag)
        {
            
throw Error.DbEntityEntry_DottedPartNotComplex(properties[0], propertyName, declaringType.Name);
        }
        
throw (requireComplex ? Error.DbEntityEntry_NotAComplexProperty(properties[0], declaringType.Name) : Error.DbEntityEntry_NotAScalarProperty(properties[0], declaringType.Name));
    }
    InternalPropertyEntry entry 
= (InternalPropertyEntry) metadata.CreateMemberEntry(this, parentProperty);
    
if (!flag)
    {
        
return entry;
    }
    
return this.Property(entry, propertyName, properties.Skip<string>(1).ToList<string>(), requestedType, requireComplex);

从标黄的语句中不难发现,这个函数也是递归调用,并且将多层的property一一解析。 System.Data.Entity.Internal.InternalEntityEntry.Property函数返回InternalPropertyEntry类型的对象。这个对象又被返回给DbPropertyEntry.Create方法,Create方法又调用了InternalPropertyEntry.CreateDbMemberEntry:

 

public override DbMemberEntry<TEntity, TProperty> CreateDbMemberEntry<TEntity, TProperty>() where TEntity: class
{
    
if (!this.EntryMetadata.IsComplex)
    {
        
return new DbPropertyEntry<TEntity, TProperty>(this);
    }
    
return new DbComplexPropertyEntry<TEntity, TProperty>(this);
}

 

这里的逻辑很简单,将property分成一般的属性或复杂类型的属性,分别处理之。分析到这里,大家应该也发现了DbPropertyEntry中大部分信息都保存在其内部的InternalPropertyEntry对象里。这样的设计在解析EntityFramework.dll时,我们会经常看到。

 

呼!这篇文章不是一口气写完的了,这几天挺忙的,不过每天添几笔,可能思路有些混乱,大家见谅,哈哈!还是那句话,希望对您学习EF有点帮助吧!

 

PS1:这里为大家带来一个好消息:微软一站式实例代码库(Microsoft All-In-One Code Framework)即日起正式迁移至MSDN代码库了,新的平台会帮您更轻松地解决开发难题、节省更多时间、获得更友好的用户体验。本人作为这个项目的元老,见到我们已拥有600多个经典的代码实例,甚感欣慰啊!  更详细信息,请看http://msdn.microsoft.com/zh-cn/hh124104.aspx?ocid=ban-f-cn-loc-OC201104-MSDN

之后我将尽力为大家带来更多有关EF的代码实例以及相关的介绍!



PS2:同事开发了一个很cool的MSDN论坛桌面小工具,绝对给力!欢迎使用!(我也出了不少力啊


也欢迎到MSDN中文论坛ADO.NET与LINQ论坛来提问EF的问题啊,可以试试直接报我的名字Michael Sun,哈哈!

 

如需转发请注明原文出处,谢谢: http://www.cnblogs.com/LingzhiSun/archive/2011/04/13/EF41_WokingWithProperties.html

posted @ 2011-04-13 09:32 LingzhiSun 阅读(...) 评论(...) 编辑 收藏