（完全限定类名：
DataRabbit.ORM.IEntityRelationLoader
）
在DataRabbit框架提供的ORM功能之中，除了IOrmAccesser接口展现的核心ORM功能外，IEntityRelationLoader接口也提供了一些有意义的功能。正如其名，IEntityRelationLoader是通过数据表的主外键关系来加载当前Entity的Parent和Children。
现在对我们前面示例经常用到的Student数据表做个扩充，假设，Student表的MentorID字段作为外键，指向Mentor表；而且，Book表中的StudentID字段也是外键，指向Student表。这种主外键关系的含义是：“一个学生有一个导师，并且拥有多本书”。这三个表的关系图如下所示：
通过对Student扩充后，我们可以为Student Entity Class 加上如下两个属性，来反映这种关系：
现在，我们来调用如下语句：
我们可以从DataRabbit的入口点 IDataAccesser 接口获取IEntityRelationLoader引用：
通过上面的示例，我们对IEntityRelationLoader的功能已经有了一些了解。下面我们来看看这个接口的全貌：
转到： DataRabbit 轻量的数据访问框架 －－ 序
在DataRabbit框架提供的ORM功能之中，除了IOrmAccesser接口展现的核心ORM功能外，IEntityRelationLoader接口也提供了一些有意义的功能。正如其名，IEntityRelationLoader是通过数据表的主外键关系来加载当前Entity的Parent和Children。
现在对我们前面示例经常用到的Student数据表做个扩充，假设，Student表的MentorID字段作为外键，指向Mentor表；而且，Book表中的StudentID字段也是外键，指向Student表。这种主外键关系的含义是：“一个学生有一个导师，并且拥有多本书”。这三个表的关系图如下所示：
通过对Student扩充后，我们可以为Student Entity Class 加上如下两个属性，来反映这种关系：
#region
Mentor
[ NonSerialized ]
private Mentor m_Mentor = null ;
public Mentor Mentor
{
get
{
return this .m_Mentor;
}
set
{
this .m_Mentor = value;
}
}
#endregion
#region BookList
[ NonSerialized ]
private IList < Book > m_BookList = null ;
public IList < Book > BookList
{
get
{
return this .m_BookList;
}
set
{
this .m_BookList = value;
}
}
#endregion
我将这种通过主外键关系得到的属性称为“FamilyRelation”属性，如果使用
EntityCreator
工具生成Entity Class，这些属性都会根据数据表关系而自动生成。
[ NonSerialized ]
private Mentor m_Mentor = null ;
public Mentor Mentor
{
get
{
return this .m_Mentor;
}
set
{
this .m_Mentor = value;
}
}
#endregion
#region BookList
[ NonSerialized ]
private IList < Book > m_BookList = null ;
public IList < Book > BookList
{
get
{
return this .m_BookList;
}
set
{
this .m_BookList = value;
}
}
#endregion
现在，我们来调用如下语句：
Studentstudent
=
stuOrmAccesser.GetOne(
new
Filter
(Student._ID,
30
));
结果会发现，返回的student对象的Mentor属性和BookList属性不会被填充。如果不使用IEntityRelationLoader接口，而是直接通过IOrmAccesser来获取这个student的“Family”，我们需要这样做：
Student student
=
stuOrmAccesser.GetOne(
new
Filter
(Student._ID,
30
));
student.Mentor = stuOrmAccesser.GetParent < Mentor > (student);
student.BookList = stuOrmAccesser.GetChildList < Book > (student);
像这样子可以达到目的，但是未免繁琐了一点，如果Student表有多个外键，则我们就要调用多次GetParent（）方法来分别获取各个Parent；对于多个Children，也是如此。IEntityRelationLoader接口使得这种基于关系的加载变得非常简单，如上述功能使用下面的代码即可实现：
student.Mentor = stuOrmAccesser.GetParent < Mentor > (student);
student.BookList = stuOrmAccesser.GetChildList < Book > (student);
entityRelationLoader.
LoadFamily
(student);
LoadFamily
方法一次调用可以加载当前student对象的所有“Family”成员（注意，这里的加载“Family”只包括加载自己Parent和Children，而不包括更上的grandfather或更下的grandson等）。
我们可以从DataRabbit的入口点 IDataAccesser 接口获取IEntityRelationLoader引用：
IEntityRelationLoader
entityRelationLoader
=
dataAccesser.GetEntityRelationLoader(
null
);
通过上面的示例，我们对IEntityRelationLoader的功能已经有了一些了解。下面我们来看看这个接口的全貌：
public
interface
IEntityRelationLoader
:
ITransactionAccesser
{
/// <summary>
/// LoadChildren加载自己的children到对应的属性字段（如果Entity提供了这些属性字段，并且属性可写）上。
/// </summary>
void LoadChildren( object entity);
/// <summary>
/// LoadParents加载自己的parents到对应的属性字段（如果Entity提供了这些属性字段，并且属性可写）上。
/// </summary>
void LoadParents( object entity);
/// <summary>
/// LoadFamily加载自己的parents和children到对应的属性字段（如果Entity提供了这些属性字段，并且属性可写）上。
/// </summary>
void LoadFamily( object entity);
/// <summary>
/// LoadOffspring以当前entity为根，加载所有后代。注意，自己以及后代的所有Parent属性都不会被赋值。
/// </summary>
void LoadOffspring( object entity);
}
{
/// <summary>
/// LoadChildren加载自己的children到对应的属性字段（如果Entity提供了这些属性字段，并且属性可写）上。
/// </summary>
void LoadChildren( object entity);
/// <summary>
/// LoadParents加载自己的parents到对应的属性字段（如果Entity提供了这些属性字段，并且属性可写）上。
/// </summary>
void LoadParents( object entity);
/// <summary>
/// LoadFamily加载自己的parents和children到对应的属性字段（如果Entity提供了这些属性字段，并且属性可写）上。
/// </summary>
void LoadFamily( object entity);
/// <summary>
/// LoadOffspring以当前entity为根，加载所有后代。注意，自己以及后代的所有Parent属性都不会被赋值。
/// </summary>
void LoadOffspring( object entity);
}
转到： DataRabbit 轻量的数据访问框架 －－ 序
