XPO学习系列2

十二、对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]

（未完）