指定查询

在此页面上

Overview

字面值
比较操作符。
逻辑操作符
数组操作符
元素操作符
评估操作符
更多信息

Overview

在本指南中，您可以了解如何使用 MongoDB .NET/C# 驱动程序指定查询。

您可以通过创建查询筛选器来缩小查询返回的匹配文档集的范围。查询筛选器是一个表达式，用于指定要在读取、更新或删除操作中匹配的文档。

注意

使用 LINQ

本指南介绍如何使用查询筛选器指定查询。还可以使用 LINQ 指定查询。要学习；了解有关使用 LINQ 的更多信息，请参阅 LINQ。

本指南中的示例使用名为 guitars 的集合中的以下文档：

{ "_id": 1, "make": "Fender", "models": ["Stratocaster", "Telecaster"], "establishedYear": 1946, "rating": 9 }
{ "_id": 2, "make": "Gibson", "models": ["Les Paul", "SG", "Explorer"], "establishedYear": 1902, "rating": 8 }
{ "_id": 3, "make": "PRS", "models": ["Silver Sky", "SE", "Custom"], "establishedYear": 1985, "rating": 9 }
{ "_id": 4, "make": "Kiesel", "models": ["Ares", "Vader", "Solo"], "establishedYear": 2015 }
{ "_id": 5, "make": "Ibanez", "models": ["RG", "AZ"], "establishedYear": 1957, "rating": 7 }
{ "_id": 6, "make": "Strandberg", "models": ["Boden", "Salen"], "establishedYear": 1982 }

以下 Guitar 类对此集合中的文档进行建模。

public class Guitar
{
    public int Id { get; set; }
    public string Make { get; set; }
    public List<string> Models { get; set; }
    public int EstablishedYear { get; set; }
    public int? Rating { get; set; }
}

注意

guitars 集合中的文档使用驼峰命名约定。本指南中的示例使用 ConventionPack 将集合中的字段反序列化为 Pascal 语句，然后映射到 Guitar 类中的属性。

如需了解有关自定义序列化的更多信息，请参阅“自定义序列化”。

如需了解有关类映射的更多信息，请参阅“类映射”。

以下代码使用 Guitar 类作为类型参数来实例化 _guitarsCollection 对象。此类型参数使驱动程序自动将其发送到 MongoDB 和从 MongoDB 接收的文档自动序列化和反序列化为 Guitar 类的实例：

private static IMongoCollection<Guitar> _guitarsCollection;

字面值

字面值查询返回与查询筛选器精确匹配的文档。

以下示例将查询筛选器指定为 Find() 方法的参数。该查询匹配 make 字段等于 " Fender " 的所有文档。

// Finds all documents with a "make" value of "Fender"
var results = _guitarsCollection.Find(g => g.Make == "Fender").ToList();
foreach (var doc in results)
{
    // Prints the documents in bson (json) format
    Console.WriteLine(doc.ToBsonDocument());
}

{ "_id" : 1, "make" : "Fender", "models" : ["Stratocaster", "Telecaster"], "establishedYear" : 1946, "rating" : 9 }

以下示例使用构建器创建一个查询筛选器，该筛选器匹配的文档与前面的示例相同：

// Creates a filter for all documents with a "make" value of "Fender"
var filter = Builders<Guitar>.Filter.Eq(g => g.Make, "Fender");
// Finds all documents that match the filter
var result = _guitarsCollection.Find(filter).ToList();
foreach (var doc in result)
{
    // Prints the documents in bson (json) format
    Console.WriteLine(doc.ToBsonDocument());
}

{ "_id" : 1, "make" : "Fender", "models" : ["Stratocaster", "Telecaster"], "establishedYear" : 1946, "rating" : 9 }

提示

查找所有文档

使用空查询筛选器匹配集合中的所有文档。用生成器创建空查询筛选器，如下所示：

var result = _guitarsCollection.Find(Builders<Guitar>.Filter.Empty).ToList();

如需了解有关使用生成器的更多信息，请参阅生成器操作。

比较操作符。

比较运算符会根据查询筛选器中的指定值分析文档中的值。常见的比较运算符包括：

Operator	生成器	说明
`>`	`Gt()`	大于
`<=`	`Lte()`	小于或等于
`!=`	`Ne()`	不等于

有关比较运算符的完整列表，请参阅比较查询运算符页面。

以下示例将查询筛选器指定为 Find() 方法的参数。该查询匹配 establishedYear 字段大于 1985 的所有文档。

// Finds all documents with am "establishedYear" value greater than 1985
var results = _guitarsCollection.Find(g => g.EstablishedYear > 1985).ToList();
foreach (var doc in results)
{
    // Prints the documents in bson (json) format
    Console.WriteLine(doc.ToBsonDocument());
}

{ "_id" : 4, "make" : "Kiesel", "models" : ["Ares", "Vader", "Solo"], "establishedYear" : 2015, "rating" : null }

以下示例使用构建器创建一个查询筛选器，该筛选器匹配的文档与前面的示例相同：

// Creates a filter for all documents with an "establishedYear" value greater
// than 1985
var filter = Builders<Guitar>.Filter.Gt(g => g.EstablishedYear, 1985);
// Finds all documents that match the filter
var result = _guitarsCollection.Find(filter).ToList();
foreach (var doc in result)
{
    // Prints the documents in bson (json) format
    Console.WriteLine(doc.ToBsonDocument());
}

{ "_id" : 4, "make" : "Kiesel", "models" : ["Ares", "Vader", "Solo"], "establishedYear" : 2015, "rating" : null }

如需了解有关使用生成器的更多信息，请参阅生成器操作。

逻辑操作符

逻辑操作符使用应用于两组或多组表达式结果的逻辑来匹配文档。以下是一些逻辑操作符的列表：

Operator	生成器	说明
`&&`	`And()`	所有表达式的计算结果都必须为 True。
`\|\|`	`Or()`	至少有一个表达式的计算结果必须为 True。

有关逻辑运算符的完整列表，请参阅“逻辑查询运算符”页面。

以下示例将查询筛选器指定为 Find() 方法的参数。该查询匹配 establishedYear 字段大于或等于 1985 且 make 字段不等于 "Kiesel" 的所有文档。

// Finds all documents with an "establishedYear" value greater than 1985
// and a "make" value that is not equal to "Kiesel"
var results = _guitarsCollection.Find(g => g.EstablishedYear >= 1985 && r.Make != "Kiesel").ToList();
foreach (var doc in results)
{
    // Prints the documents in bson (json) format
    Console.WriteLine(doc.ToBsonDocument());
}

{ "_id" : 3, "make" : "PRS", "models" : ["Silver Sky", "SE", "Custom"], "establishedYear" : 1985, "rating" : 9 }

以下示例使用构建器创建一个查询筛选器，该筛选器匹配的文档与前面的示例相同：

// Creates a filter for all documents with an "establishedYear" value greater
// than 1985 and a "make" value that does not equal "Kiesel"
var builder = Builders<Guitar>.Filter;
var filter = builder.And(builder.Gte(g => g.EstablishedYear, 1985), builder.Ne(r => r.Make, "Kiesel"));
// Finds all documents that match the filter
var result = _guitarsCollection.Find(filter).ToList();
foreach (var doc in result)
{
    // Prints the documents in bson (json) format
    Console.WriteLine(doc.ToBsonDocument());
}

{ "_id" : 3, "make" : "PRS", "models" : ["Silver Sky", "SE", "Custom"], "establishedYear" : 1985, "rating" : 9 }

如需了解有关使用生成器的更多信息，请参阅生成器操作。

数组操作符

数组操作符根据数组字段中元素的值或数量匹配文档。以下是使用数组操作符的构建器方法的列表：

Operator	说明
`All()`	如果数组字段包含查询中指定的所有元素，则匹配文档。
`Any()`	如果数组字段中的任意元素与指定的查询筛选器匹配，则匹配文档。
`Size()`	如果数组字段为指定大小，则匹配文档。

注意

Any() 构建器使用 $elemMatch 查询运算符。

要了解有关$elemMatch查询选择器的更多信息，请参阅$elemMatch。

有关数组操作符的更多信息，请参阅数组查询操作符页面。

以下示例使用构建器创建一个查询筛选器，该筛选器匹配 models 字段中有 3 个元素的所有文档：

// Creates a filter for all documents with 3 elements in the "models" field
var filter = Builders<Guitar>.Filter.Size(g => g.Models, 3);
// Finds all documents that match the filter
var result = _guitarsCollection.Find(filter).ToList();
foreach (var doc in result)
{
    // Prints the documents in bson (json) format
    Console.WriteLine(doc.ToBsonDocument());
}

{ "_id" : 2, "make" : "Gibson", "models" : ["Les Paul", "SG", "Explorer"], "establishedYear" : 1902, "rating" : 8 }
{ "_id" : 3, "make" : "PRS", "models" : ["Silver Sky", "SE", "Custom"], "establishedYear" : 1985, "rating" : 9 }
{ "_id" : 4, "make" : "Kiesel", "models" : ["Ares", "Vader", "Solo"], "establishedYear" : 2015, "rating" : null }

如需了解有关使用生成器的更多信息，请参阅生成器操作。

元素操作符

元素操作符根据字段的存在或类型查询数据。

有关元素运算符的完整列表，请参阅元素查询运算符页面。

以下示例使用构建器创建一个查询筛选器，该筛选器匹配具有 rating 字段的所有文档：

// Creates a filter for all documents with a populated "ratings" field
var filter = Builders<Guitar>.Filter.Exists(g => g.Rating);
// Finds all documents that match the filter
var result = _guitarsCollection.Find(filter).ToList();
foreach (var doc in result)
{
    // Prints the documents in bson (json) format
    Console.WriteLine(doc.ToBsonDocument());
}

{ "_id" : 1, "make" : "Fender", "models" : ["Stratocaster", "Telecaster"], "establishedYear" : 1946, "rating" : 9 }
{ "_id" : 2, "make" : "Gibson", "models" : ["Les Paul", "SG", "Explorer"], "establishedYear" : 1902, "rating" : 8 }
{ "_id" : 3, "make" : "PRS", "models" : ["Silver Sky", "SE", "Custom"], "establishedYear" : 1985, "rating" : 9 }
{ "_id" : 5, "make" : "Ibanez", "models" : ["RG", "AZ"], "establishedYear" : 1957, "rating" : 7 }

如需了解有关使用生成器的更多信息，请参阅生成器操作。

评估操作符

计算操作符可分析单个字段的数据，或整个集合的文档的数据。部分使用计算操作符的生成方法包括 Regex() 和 Text()。

有关评估运算符的完整列表，请参阅评估查询运算符页面。

以下示例使用构建器创建一个查询筛选器，该筛选器匹配 make 字段中具有以字母 "G" 开头的值的所有文档：

// Creates a filter for all documents with a populated "ratings" field
var filter = Builders<Guitar>.Filter.Regex(g => g.Make, "^G");
// Finds all documents that match the filter
var result = _guitarsCollection.Find(filter).ToList();
foreach (var doc in result)
{
    // Prints the documents in bson (json) format
    Console.WriteLine(doc.ToBsonDocument());
}

{ "_id" : 2, "make" : "Gibson", "models" : ["Les Paul", "SG", "Explorer"], "establishedYear" : 1902, "rating" : 8 }

如需了解有关使用生成器的更多信息，请参阅生成器操作。