在我們最近的專案中，SQL-MAP使用較多，但是實體類用的很少，實際上，“PDF.NET資料開發框架”的實體類相當強大，下面的測試程式是在MySQL中操作的例項。

1，首先在App.config檔案中配置資料庫連線字串：

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <connectionStrings>
    <add name ="default" connectionString ="server=192.168.XX.XX;User Id=root;password=XXXX;database=test" providerName="PWMIS.DataProvider.Data.MySQL,PWMIS.MySqlClient"/>
  </connectionStrings>
</configuration>
 

2，然後定義一個“使用者”實體類：

/*
 * PDF.NET 資料開發框架
 * http://www.pwmis.com/sqlmap
 */
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using PWMIS.DataMap.Entity;

namespace TestMySqlEntity
{
    class User:EntityBase 
    {
        public User()
        {
            TableName = "tb_user";
            PrimaryKeys.Add("ID");//主鍵
            IdentityName = "ID";//標識，自增
            PropertyNames = new string[] {"ID","Name","Age" };
            PropertyValues = new object[PropertyNames.Length];

        }

        public int ID
        {
            get { return getProperty<int>("ID"); }
            set { setProperty("ID", value); }
        }

        public int Age
        {
            get { return getProperty<int>("Age"); }
            set { setProperty("Age", value); }
        }

        public string Name
        {
            get { return getProperty<string>("Name"); }
            set { setProperty("Name", value,50); }
        }
    }
}
 

3，根據這個實體類，我們去MySQL定義一個使用者表：tb_user，具體過程省略。

(此目的也是為了先有實體再有資料表，以便大家領略ORM的正真含義)

4，編寫ORM實體類操作的測試程式碼：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using PWMIS.DataMap.Entity;
namespace TestMySqlEntity
{
    class Program
    {
        static void Main(string[] args)
        {
            User u = new User();
            //*************構建 OQL 查詢表示式 ******* begin ************
            //查詢實體集合
            //使用 OQLCompare 物件作為條件
            //OQL q = OQL.From(u).Select().Where(new OQLCompare(u).Comparer(u.Age, OQLCompare.CompareType.NoSmaller, 15)).END ;
            OQL q = new OQL(u);
            //使用OQL2 作為條件物件
            q.Select().Where(q.Condition.AND(u.Age, ">=", 15)).OrderBy (u.Age ,"asc");
            //使用 QueryParameter 陣列作為條件，適合於多個並列的And條件
            //q.Select().Where(new QueryParameter[] { new QueryParameter("Age", PWMIS.Common.enumCompare.NoSmaller, 15) }).OrderBy(u.Age, "asc"); 
            Console.WriteLine("OQL to SQL:rn"+q.ToString ());
            
            //*************構建 OQL 查詢表示式 ******* end ************
            //查詢實體列表
            var result = EntityQuery<User>.QueryList(q);
            Console.WriteLine("查詢實體集合成功，數量："+result .Count );
            Console.WriteLine("rnExecuted SQL Text:rn{0}rn", PWMIS.DataProvider.Data.CommandLog.Instance.CommandText);
            //查詢單個實體
            u.Name = "zhang san";
            q.Select().Where(u.Name);
            Console.WriteLine("OQL to SQL:rn" + q.ToString());
            User u1 = EntityQuery<User>.QueryObject(q);
            if (u1 != null)
                Console.WriteLine("查詢單個實體成功！");
            Console.WriteLine("rnExecuted SQL Text:rn{0}rn", PWMIS.DataProvider.Data.CommandLog.Instance.CommandText);

            //直接使用EntityQuery<T>.Instance 屬性的插入、修改、刪除方法
            u.Name = "li si3";
            u.Age = 15;
            if (EntityQuery<User>.Instance.Insert(u) > 0)
                Console.WriteLine("插入實體成功！"); //將自動為ID屬性賦值
            Console.WriteLine("rnExecuted SQL Text:rn{0}rn", PWMIS.DataProvider.Data.CommandLog.Instance.CommandText);
            u.Age = 25;
            if (EntityQuery<User>.Instance.Update (u) > 0)
                Console.WriteLine("修改實體成功！");
            Console.WriteLine("rnExecuted SQL Text:rn{0}rn", PWMIS.DataProvider.Data.CommandLog.Instance.CommandText);
            User u2 = new User();
            u2.Name = "wang wu";
            u2.Age = 20;
            //使用EntityQuery<T> 的例項物件方法更新實體
            //只會更新賦值過的屬性值
            EntityQuery<User> eq = new EntityQuery<User>(u2);
            if (eq.SaveAllChanges() > 0)
                Console.WriteLine("更新實體成功！");
            Console.WriteLine("rnExecuted SQL Text:rn{0}rn", PWMIS.DataProvider.Data.CommandLog.Instance.CommandText);
            Console.Read();
        }
    }
}
 

5，編譯執行，得到下面的結果：

OQL to SQL: SELECT [ID],[Name],[Age]  FROM [tb_user]    Where  [Age] >= @Age0         Order by [Age] asc 查詢實體集合成功，數量：23

Executed SQL Text: SELECT `ID`,`Name`,`Age`  FROM `tb_user`    Where  `Age` >= @Age0         Order by `Age` asc

OQL to SQL: SELECT [ID],[Name],[Age]  FROM [tb_user]    Where Name=@Name

查詢單個實體成功！

Executed SQL Text: SELECT `ID`,`Name`,`Age`  FROM `tb_user`    Where Name=@Name

插入實體成功！

Executed SQL Text: INSERT INTO `tb_user`(`Name`,`Age`) VALUES (@P0,@P1)

修改實體成功！

Executed SQL Text: UPDATE `tb_user` SET `Age`=@P0 WHERE `ID`=@P1

更新實體成功！

Executed SQL Text: INSERT INTO `tb_user`(`Name`,`Age`) VALUES (@P0,@P1)

6，結果說明

我們看到整個操作都成功了，特別注意這個：

UPDATE `tb_user` SET `Age`=@P0 WHERE `ID`=@P1

當時我們只給Age屬性重新賦值了，所以生成的更新語句也僅僅更新了該欄位。

實體類查詢OQL表示式可以有多種Where條件構造方式，具體請看上面的程式碼。