代码改变世界

ALinq Dynamic 使用指南——慨述(上)

2014-05-15 17:06  麦舒  阅读(909)  评论(0编辑  收藏  举报

一.使用

1.程序集与命名空间的引用
使用 ALinq Dynamic,你需要引用ALinq.Dynamic.dll(ALinq用户)或者System.Data.Linq.Dynamic.dll (Linq to SQL用户),在使用时,还需要引入ALinq.Dynamic命名空间。当然,使用前你还需要完成建模的工作,本文假设你已经会了,否则请参考Linq to SQL或ALinq教程。

示例一

下面的示例,由于使用到dynamic关键字,必须运行在.NET Framework4或以上。

using System;
using ALinq.Dynamic;
using NorthwindDemo;
namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            var db = new NorthwindDataContext();
            var q = db.CreateQuery("select e.FirstName, e.LastName from Employees as e");
            foreach (var item in q)
            {
                var e = item as dynamic;
                Console.WriteLine("{0} {1}", e.FirstName, e.LastName);
            }
        }
    }
}

示例二

下面的示例可以运行在.NET Framework 3.5(为了便于阅读以及节省编幅,仅给出关键部份代码)。

var db = new NorthwindDataContext();
var q = db.CreateQuery<IDataRecord>("select e.FirstName, e.LastName from Employees as e");
foreach (var e in q)
    Console.WriteLine("{0} {1}", e["FirstName"], e["LastName"]);

二.大小敏感

1.关键词不区分大小写

对于关键词是不区分大小写的,例如下面的这两条ESQL语句是相等的。

语句一

select p from Product as p

语句二

SELECT p FROM Product AS p

2.命名空间区分大小写

对于命名空间,是区分大小写的,例如下面的两条ESQL语句是不等价的。

语句一

using NorthwindDemo 
select p from Product as p

语句二

using NORTHWINDDEMO
SELECT p FROM Product AS p

这是因为命名空间是区分大小区的,NorthwindDemo 和 NORTHWINDDEMO是不等价的。

三.命名空间

1.using 关键字

通过使用 using 关键字,可以引入命名空间,避免使用全局标识。例如:

var esql = @"using NorthwindDemo;
             select e.FirstName, e.LastName 
             from Employee as e";
var q1 = db.CreateQuery(esql);

其等效于:

var esql = @"select e.FirstName, e.LastName 
             from NorthwindDemo.Employee as e";
var q1 = db.CreateQuery(esql);

2.默认引用的命名空间

在使用 CreateQuery 方法进行查询的时候,ALinq Dynamic 会自动引入 DataContext 所在的命名空间。例如:

var db = new NorthwindDemo.NorthwindDataContext();
var esql = "select e.FirstName, e.LastName from Employee as e";

由于 DataContext ,即 db 变量,对应的实体类命名空间为 NorthwindDemo, esql 语句会自动引入 NothwindDemo 命名空间,即等效于下面的语句:

var db = new NorthwindDemo.NorthwindDataContext();
var esql = @"using NorthwindDemo;
             select e.FirstName, e.LastName from Employee as e";

四.标识符

1.简单标识符

标识符由字母,数字,和下划线组成,并且第一个字符必须是字母(a-z或A-Z)。

2.带引号的标识符

带引号的标识符是括在方括号([])中的任意字符序列。使用带引号的标识符可以指定含有在标识符中无效的字符的标识符。方括号中的所有字符都是标识符的一部分,包括所有空格。
但是,带引号的标识符,第一个字符不能是数字,并且不能包含以下字符:

换行符
回车符
制表符
Backspace
额外的方括号(即括起标识符的方括号中的方括号)。
单引号(即:')
双引号(即:")

使用带引号的标识符可以创建在标识符中无效的属性名称字符,如下面的示例所示:

var esql = "select c.ContactName as [Contact Name] from Customers as c";
var q = db.CreateQuery(esql).Execute();

使用带引号的标识符,还可以指定关键字作为标识符。例如,如果类型 Email 具有名为“From”的属性,则可以使用方括号来消除与保留关键字“FROM”的歧义,如下所示:

var esql = "select e.[From] from Emails AS e";

但是下面的例子是非法的
标识符中带引号

var esql = "select c.ContactName as ['Contact Name'] from Customers as c";

标识符以数字开始

var esql = "select c.ContactName as [0ContactName] from Customers as c";

3.别名规则

如果需要,建议在查询中指定别名,别名可以应用于:

行构造函数
查询语句的 FROM 子句
查询语句的 SELECT 子句
查询语句的 GROUP BY 子句

有效的别名
有效的别外包括简单标识符或者带引号的标识符

五.参数

参数是查询语句之外定义的变量,参数名在查询语句中定义,并以(@)符号作为前缀。这可以将它们与属性名或查询中定义的其它名称区分开来。参数为两类,命名参数和顺序参数,对于命名参数,必须指名称,参数的传递不要按照顺序。顺序参数不需要指定名称,在查询语句中使用序号(序号从0开始)作为参数名,参数必须按顺序传递。

命名参数

var esql = @"select e from Employees as e
         where e.FirstName = @f and e.LastName = @l";
var q = db.CreateQuery(esql, new ObjectParameter("l", "mak"), new ObjectParameter("f", "mike"));

顺序参数

var esql = @"select e from Employees as e
         where e.FirstName = @0 and e.LastName = @1";
var q = db.CreateQuery(esql, "mike", "mak");

六.变量

变量表达式是对当前作用域中定义的命名表达式的引用。变量引用必须是有效的标识符。
以下示例演示如何在查询语句中使用变量。FROM 子句中的 c 是变量定义。在 SELECT 子句中使用的 c 表示变量引用。

var esql = "select c.ContactName from Customers as c";