原文:XPO学习二--Attribute的总结 作者: Arming
十二、对Attribute的总结:
应该看到,整个XPO框架中,Attribute使用的相当频繁,可以列出常用的:
[Aggregated] 没有参数
作用于a property or a field,并且只能是持久类的引用或者XPCollection.
实现两个持久类的级联删除的功能。
[Association("PersonAddresses", typeof (Address))]
作用于a property or a field
实现两个持久类的级联关系
参数:1、关联的名称;2、关联的持久类类型(但引用指明持久类型时,可以省略)
[MapTo("T_Person")]
作用于持久类或a property or a field
作用于持久类时:指定持久类映射的表名称。如果没有指定,默认的表名就是类名。
作用于property或field时:表的列名称。
参数是表名或列名,是区分大小写的。
[Persistent("CreatedOn")] 强制映射字段
作用于a property or a field
XPO一般只对持久类中的可写property和public field进行持久化操作。因此对只读的field可以加上该特性进行强制持久化。
参数:表名(可选)
[NonPersistent]
作用于a class, property or a field
指明不对类或property,field进行持久化操作。
参数无。
[DbType]
指定列创建时使用的数据类型。
参数:字符串的数据类型表示。
[MapInheritance(MapInheritanceType.OwnTable)]
作用于持久类。
两个持久类是继承关系时,持久信息的存储方式。
参数:
MapInheritanceType.OwnTable :各自独立的表,分别存储独有部分。
MapInheritanceType.ParentTable :都在父表存储。
[Delayed("document")]
只能作用于Property。
延迟数据装载,当持久类构造时并不装载数据,只是property首次被访问时才装载。
和类XPDelayedProperty结合使用才能实现延迟装载的功能。
参数:引用的XPDelayedProperty 类型field 名称。
[Size(SizeAttribute.Unlimited)] 数据长度
作用范围a property or a field。
指定映射的表字段长度。只是当创建字段时才体现。当字段已经存在,XPO此时不会检查该值。
参数:数值的长度或者SizeAttribute.Unlimited(不限制长度)
可以不指定。如果是string,默认是100。
[Key ] ,[Key(true)],[Key(AutoGenerate = true)]
作用于a property or a field。
指定主键。每个持久类都需要一个指定为key的propery or field。XPObject和XPBaseObject的一个明显差别就是XPObject已有一个OId主键
参数:bool型(可选)。是否由XPO自动生成键值(Int或GUID)。默认是false。
[Indexed]
作用于a property or a field。
指定索引。默认情况下改索引是非唯一索引。
没有构造参数。但可以通过set来设置为唯一索引[Indexed(Unique=true)]
[OptimisticLocking(false)]
作用于持久类。
是否乐观锁定(感谢format 的指错)。如果锁定,修改后提交时,XPO会检查原始数据是否已经被改变,而不是who lastest who win。XPO在持久类映射的表类加一个系统字段“OptimisticLockField”,显然是用来标记状态的。因此如果是映射到视图时,要显式设置为不锁定。
参数:bool值(可选,默认是true)
[ValueConverter(typeof(实现转换接口(抽象类ValueConverter)的类))]
作用于property。
值和类型转换,挺有意思的一个功能。从数据库提取值和保存值都可以作一个转换工作。
[NullValue("")]
作用于简单数据类型的a property or field。
指定对应库中值为null时,持久类中对应的数据。反之也是。
参数:根据不同的数据类型,引入不同的参数。看例子比较方便:
public class Example : XPObject {
[NullValue(Int32.MinValue)]
public int NullOnMinValueFieldInt;
[NullValue(0)]
public int NullOnZeroFieldInt;
[NullValue("")]
public string NullOnEmptyStringFieldString;
[NullValue("NULL")]
public string NullOnNULLFieldString;
}
本想只列出常用的,但看看代码,就差两个就列完了。
[ExplicitLoading]
[MemberDesignTimeVisibility]
(未完)
[Aggregated] 没有参数
作用于a property or a field,并且只能是持久类的引用或者XPCollection.
实现两个持久类的级联删除的功能。
[Association("PersonAddresses", typeof (Address))]
作用于a property or a field
实现两个持久类的级联关系
参数:1、关联的名称;2、关联的持久类类型(但引用指明持久类型时,可以省略)
[MapTo("T_Person")]
作用于持久类或a property or a field
作用于持久类时:指定持久类映射的表名称。如果没有指定,默认的表名就是类名。
作用于property或field时:表的列名称。
参数是表名或列名,是区分大小写的。
[Persistent("CreatedOn")] 强制映射字段
作用于a property or a field
XPO一般只对持久类中的可写property和public field进行持久化操作。因此对只读的field可以加上该特性进行强制持久化。
参数:表名(可选)
[NonPersistent]
作用于a class, property or a field
指明不对类或property,field进行持久化操作。
参数无。
[DbType]
指定列创建时使用的数据类型。
参数:字符串的数据类型表示。
[MapInheritance(MapInheritanceType.OwnTable)]
作用于持久类。
两个持久类是继承关系时,持久信息的存储方式。
参数:
MapInheritanceType.OwnTable :各自独立的表,分别存储独有部分。
MapInheritanceType.ParentTable :都在父表存储。
[Delayed("document")]
只能作用于Property。
延迟数据装载,当持久类构造时并不装载数据,只是property首次被访问时才装载。
和类XPDelayedProperty结合使用才能实现延迟装载的功能。
参数:引用的XPDelayedProperty 类型field 名称。
[Size(SizeAttribute.Unlimited)] 数据长度
作用范围a property or a field。
指定映射的表字段长度。只是当创建字段时才体现。当字段已经存在,XPO此时不会检查该值。
参数:数值的长度或者SizeAttribute.Unlimited(不限制长度)
可以不指定。如果是string,默认是100。
[Key ] ,[Key(true)],[Key(AutoGenerate = true)]
作用于a property or a field。
指定主键。每个持久类都需要一个指定为key的propery or field。XPObject和XPBaseObject的一个明显差别就是XPObject已有一个OId主键
参数:bool型(可选)。是否由XPO自动生成键值(Int或GUID)。默认是false。
[Indexed]
作用于a property or a field。
指定索引。默认情况下改索引是非唯一索引。
没有构造参数。但可以通过set来设置为唯一索引[Indexed(Unique=true)]
[OptimisticLocking(false)]
作用于持久类。
是否乐观锁定(感谢format 的指错)。如果锁定,修改后提交时,XPO会检查原始数据是否已经被改变,而不是who lastest who win。XPO在持久类映射的表类加一个系统字段“OptimisticLockField”,显然是用来标记状态的。因此如果是映射到视图时,要显式设置为不锁定。
参数:bool值(可选,默认是true)
[ValueConverter(typeof(实现转换接口(抽象类ValueConverter)的类))]
作用于property。
值和类型转换,挺有意思的一个功能。从数据库提取值和保存值都可以作一个转换工作。
[NullValue("")]
作用于简单数据类型的a property or field。
指定对应库中值为null时,持久类中对应的数据。反之也是。
参数:根据不同的数据类型,引入不同的参数。看例子比较方便:
public class Example : XPObject {
[NullValue(Int32.MinValue)]
public int NullOnMinValueFieldInt;
[NullValue(0)]
public int NullOnZeroFieldInt;
[NullValue("")]
public string NullOnEmptyStringFieldString;
[NullValue("NULL")]
public string NullOnNULLFieldString;
}
本想只列出常用的,但看看代码,就差两个就列完了。
[ExplicitLoading]
[MemberDesignTimeVisibility]
(未完)