formatuu 发表于 2015-7-6 00:02:24

MongoDB学习(翻译2)

C#驱动之LINQ教程

介绍

本教程涵盖了1.8发布版本对linq查询的支持。
开始本教程之前,你应该至少阅读下C#驱动教程关于C#驱动的介绍

快速开始

首先,添加下面命名空间到您的程序中:



using MongoDB.Driver.Linq;
  
然后,声明一变量保存对集合的引用



var collection = database.GetCollection("collectionname");
  
最基本调用linq查询的方式是构造一个集合变量,通过调用AsQueryable() 后,你便可以正常调用linq了。
实例:



var query =
from e in collection.AsQueryable()
where e.FirstName == "John"
select e;

foreach (var employee in query)
{
// do something

}
  
当然,你也可以通过lambda语法写查询表达式,先前的查询语句等同于下面的写法:



var query =
collection.AsQueryable()
.Where(e => e.FirstName == "John");
  
C#编译器会在内部把所有查询翻译为lambda句法,所以这两种写法没有优略之分,当你需要的时候(比如某些查询操作符不被支持的时候),你甚至可以混用这两种方式。
本教程实例中所有代码均会展示linq查询表达式和lamdba表达式(在查询操作符被支持的前提下).
只有linq查询可以转化为相应的MongoDB查询时该查询才会被支持解析,如果你写的linq查询不能被转化成相应的MongoDB查询,那么您的程序会在产生异常或者错误。

支持的LINQ查询操作符

本节介绍支持的LINQ查询操作符。


[*]Any

不含谓词的Any只是测试集合中是否存在any文档对象(any直接引用过来,大家都明白)



var result =
(from c in collection.AsQueryable()
select c)
.Any();
// 或者
var result =
collection.AsQueryable()
.Any();
  


[*]Any(含谓词)

含有谓词的Any用来测试集合中是否存在匹配的文档,匹配逻辑在谓词中



var result =
(from c in collection.AsQueryable()
select c)
.Any(c => c.X == 1);
// or
var result =
collection.AsQueryable()
.Any(c => c.X == 1);
  
投影操作后,带有谓词的Any是不被支持的(至少当前版本),所以下面代码是不可用的。



var result =
collection.AsQueryable()
.Select(c => c.X)
.Any(x => x == 1);
  
通常来说,你可以使用where字句来替代投影操作,这样你可以移除投影操作。


[*]Count

不带谓词的Count只是返回文档对象在集合中数量。



var result =
(from c in collection.AsQueryable()
select c)
.Count();
// 或者
var result =
collection.AsQueryable()
.Count();
  


[*]Count(带谓词)

带有谓词的Count返回谓词匹配的文档数量。



var result =
(from c in collection.AsQueryable()
select c)
.Count(c => c.X == 1);
// or
var result =
collection.AsQueryable()
.Count(c => c.X == 1);
  
说明:谓词同样可以通过where字句和不带谓词的Count替代,所以上面实例也可以这样写:



var result =
(from c in collection.AsQueryable()
where c.X == 1
select c)
.Count();
// or
var result =
collection.AsQueryable()
.Where(c => c.X == 1)
.Count();
  
含有谓词的Count同样不支持投影后操作,所以下面写法是无效的。



var result =
collection.AsQueryable()
.Select(c => c.X)
.Count(x => x == 1);
  
解决方案和Any一样。


[*]Distinct

Distinct 返回集合中文档对象字段或者属性的唯一值,你可以投影后通过它过滤重复值。



var result =
(from c in collection.AsQueryable()
select c.X)
.Distinct();
// or
var result =
collection.AsQueryable()
.Select(c => c.X)
.Distinct();
  
投影必须选择一个特定的字段或属性的文件。如果该字段或属性的值是在MongoDB中表示,作为一个数组,你也可以使用数组索引从数据中选择一项:



var result =
(from c in collection.AsQueryable()
select c.A)
.Distinct();
// or
var result =
collection.AsQueryable()
.Select(c => c.A)
.Distinct();
  


[*]ElementAt

ElementAt 从结果集中返回一个特定的文档,通常要和排序操作一起使用



var result =
(from c in collection.AsQueryable()
where c.X > 0
orderby c.X
select c)
.ElementAt(index);
// or
var result =
collection.AsQueryable()
.Where(c => c.X > 0)
.OrderBy(c => c.X)
.ElementAt(index);
  
如果结果集中文档对象数量少于ElementAt 中索引,会报出异常。


[*]ElementAtOrDefault

ElementAtOrDefault 和ElementAt 类似,区别在于当集合中对象少于Index时前者返回null而不是报出异常。


[*]First

First 返回集合中第一个对象,通常和排序一起使用。



var result =
(from c in collection.AsQueryable()
where c.X > 0
orderby c.X
select c)
.First();
// or
var result =
collection.AsQueryable()
.Where(c => c.X > 0)
.OrderBy(c => c.X)
.First();
  
如果集合为空,则First抛出异常


[*]First(含谓词)

此重载允许你提供谓词逻辑给First,相当于使用where字句的first查询。



var result =
(from c in collection.AsQueryable()
orderby c.X
select c)
.First(c => c.X > 0);
// or
var result =
collection.AsQueryable()
.OrderBy(c => c.X)
.First(c => c.X > 0);
  
First (含有谓词)同样不支持投影后操作,所以下面代码是无效的:



var result =
collection.AsQueryable()
.OrderBy(c => c.X)
.Select(c => c.X)
.First(x => x > 0);
  
解决方案同样和Any一样
如果集合为空,同样会抛出异常


[*]FirstOrDefault

FirstOrDefault和First 不同之处在于,当集合为空时,不会抛出异常,而是返回null


[*]FirstOrDefault(含谓词)

FirstOrDefault (含谓词)和First(含谓词)用法一样,不同之处在于,集合为空时,返回null不会抛出异常


[*]Last

Last 从结果集中返回最后一个文档对象,和First相对,通常和排序操作一起使用:



var result =
(from c in collection.AsQueryable()
where c.X > 0
orderby c.X
select c)
.Last();
// or
var result =
collection.AsQueryable()
.Where(c => c.X > 0)
.OrderBy(c => c.X)
.Last();
  
如果集合为空,会抛出异常。


[*]Last(含谓词)

此重载允许你传递谓词逻辑作为参数给Last,和不带谓词的Last操作加上where字句相当。



var result =
(from c in collection.AsQueryable()
orderby c.X
select c)
.Last(c => c.X > 0);
// or
var result =
collection.AsQueryable()
.OrderBy(c => c.X)
.Last(c => c.X > 0);
  
Last 同样不支持投影后操作,所以下面写法是无效的:



var result =
collection.AsQueryable()
.OrderBy(c => c.X)
.Select(c => c.X)
.Last(x => x > 0);
  
解决方案和Any一样。
如果集合为空,会抛出异常


[*]LastOrDefault

LastOrDefault 和 Last 不同之处在于,前者当集合为空时不会抛出异常,只是返回null


[*]LastOrDefault(含谓词)

LastOrDefault(含谓词)和 Last (含谓词)用法一样,不同之处在于前者在集合为空时返回null,不会抛出异常。


[*]LongCount

LongCount 用法和Count 一样,不同之处在于返回值前者是64位长整型,后者是32位。


[*]LongCount(含谓词)

LongCount (含谓词)和Count (含谓词)用法一样,不同之处在于返回值前者是64位长整型,后者是32位。


[*]Max

Max 返回集合中文档对象属性或者字段值中的最大值,你可以筛选出投影操作识别出的字段或者属性的最大值



var result =
(from c in collection.AsQueryable()
select c.X)
.Max();
// or
var result =
collection.AsQueryable()
.Select(c => c.X)
.Max();
  
投影必须选择一个特定的字段或属性的文件。如果该字段或属性的值是在MongoDB中表示,作为一个数组,你也可以使用数组索引从数据中选择一项:



var result =
(from c in collection.AsQueryable()
select c.A)
.Max();
// or
var result =
collection.AsQueryable()
.Select(c => c.A)
.Max();
  


[*]Max(含选择器)

此Max 重载可以让你直接传递选择参数到Max来筛选最大值,可以用来代替在投影后进行Max操作:



var result =
(from c in collection.AsQueryable()
select c)
.Max(c => c.X);
// or
var result =
collection.AsQueryable()
.Max(c => c.X);
  


[*]Min

Min 返回集合中文档对象属性或者字段值中的最小值,你可以筛选出投影操作识别出的字段或者属性的最小值




var result =
(from c in collection.AsQueryable()
select c.X)
.Min();
// or
var result =
collection.AsQueryable()
.Select(c => c.X)
.Min();
  
投影必须选择一个特定的字段或属性的文件。如果该字段或属性的值是在MongoDB中表示,作为一个数组,你也可以使用数组索引从数据中选择一项:



var result =
(from c in collection.AsQueryable()
select c.A)
.Min();
// or
var result =
collection.AsQueryable()
.Select(c => c.A)
.Min();
  


[*]Min(含选择器)

此Min 重载可以让你直接传递选择参数到Max来筛选最大值,可以用来代替在投影后进行Max操作:




var result =
(from c in collection.AsQueryable()
select c)
.Min(c => c.X);
// or
var result =
collection.AsQueryable()
.Min(c => c.X);
  


[*]OfType

OfType操作符会向查询插入一个鉴别器以便你更精确的查询文档对象




var result =
(from c in collection.AsQueryable().OfType()
select c)
// or
var result =
collection.AsQueryable()
.OfType();
  


[*]OrderBy

OrderBy 用于指定结果集升序排序顺序



var query =
from c in collection.AsQueryable()
orderby c.X
select c;
// or
var query =
collection.AsQueryable()
.OrderBy(c => c.X);
  


[*]OrderByDescending

OrderByDescending用于指定结果集降序排序顺序




var query =
from c in collection.AsQueryable()
orderby c.X descending
select c;
// or
var query =
collection.AsQueryable()
.OrderByDescending(c => c.X);
  


[*]Select

Select 用于从匹配文档中选出一个新类型的结果集。Select 必须为最后一个操作(除了如 Distinct, Max 和 Min等)
注意:

Select 不会减少从服务器返回的文档对象字段或者属性,完整的文档对象还是会被返回的,然后才调用Select 方法,因此投影是在“客户端”的。



var query =
from c in collection.AsQueryable()
select new { c.X, c.Y };
// or
var query =
collection.AsQueryable()
.Select(c => new { c.X, c.Y });
  


[*]Single

Single 从结果集中返回第一个也是唯一的文件



var result =
(from c in collection.AsQueryable()
where c.X > 0
orderby c.X
select c)
.Single();
// or
var result =
collection.AsQueryable()
.Where(c => c.X > 0)
.OrderBy(c => c.X)
.Single();
  
如果结果集为空或者存在多个文档,Single 会抛出异常。


[*]Single(含谓词)

此重载可以传递参数到Single ,等同于不含谓词的Single 加上where字句。



var result =
(from c in collection.AsQueryable()
orderby c.X
select c)
.Single(c => c.X > 0);
// or
var result =
collection.AsQueryable()
.OrderBy(c => c.X)
.Single(c => c.X > 0);
  
Single 同样不支持投影后操作,所以下面代码是无效的:



var result =
collection.AsQueryable()
.OrderBy(c => c.X)
.Select(c => c.X)
.Single(x => x > 0);
  
解决方案和Any一样。
如果结果集为空或者存在多个文档,Single 会抛出异常


[*]SingleOrDefault

SingleOrDefault 和Single 用法一样,不同之处在于当集合为空或者存在多个文档对象时,会返回null,而不是抛出异常。


[*]SingleOrDefault(含谓词)

SingleOrDefault(含谓词) 和Single (含谓词)用法一样,不同之处在于当集合为空或者存在多个文档对象时,会返回null,而不是抛出异常。



[*]Skip

使用Skip ,指定从结果集开始跳过多少文件。通常情况下,你将结合排序操作使用。



var query =
(from c in collection.AsQueryable()
orderby c.X
select c)
.Skip(100);
// or
var query =
collection.AsQueryable()
.OrderBy(c => c.X)
.Skip(100);
  


[*]Take

使用Take 指定多少文件从服务器返回。结合Skip 使用时,往往你会指定一个排序顺序。



var query =
(from c in collection.AsQueryable()
orderby c.X
select c)
.Skip(100)
.Take(100);
// or
var query =
collection.AsQueryable()
.OrderBy(c => c.X)
.Skip(100)
.Take(100);
  


[*]ThenBy

ThenBy 是用来指定一个额外的升序排序的结果集。



var query =
from c in collection.AsQueryable()
orderby c.X, c.Y
select c;
// or
var query =
collection.AsQueryable()
.OrderBy(c => c.X)
.ThenBy(c => c.Y);
  


[*]ThenByDescending

ThenByDescending是用来指定一个额外的降序排序的结果集。



var query =
from c in collection.AsQueryable()
orderby c.X, c.Y descending
select c;
// or
var query =
collection.AsQueryable()
.OrderBy(c => c.X)
.ThenByDescending(c => c.Y);
  


[*]Where

WHERE子句用于指定返回满足条件查询结果。 WHERE子句是将表达查询文档类型映射到一个布尔值句法。如果表达式返回true则结果匹配到结果集中。



var query =
from c in collection.AsQueryable()
where c.X > 0
select c;
// or
var query =
collection.AsQueryable()
.Where(c => c.X > 0);
  
有时也可以使用多个where字句,其左右相当于&&操作符
例如,下面的查询是等价的:



var query =
(from c in collection.AsQueryable()
where c.X > 0
where c.Y > 0)
.First(c.Z > 0);
// or
var query =
(from c in collection.AsQueryable()
where c.X > 0 && c.Y > 0 && c.Z > 0)
.First();
  先到此为止,下节是
支持的where字句
页: [1]
查看完整版本: MongoDB学习(翻译2)