检索不同字段值
Overview
在本指南中,您可以学习;了解如何使用.NET/ C#驱动程序检索集合中指定字段的不同值。
在集合中,不同文档的单个字段可能包含不同值。示例, restaurants
集合中的一个文档的 borough
值为 "Manhattan"
,而另一文档的 borough
值为 "Queens"
。通过使用.NET/ C#驱动程序,您可以检索集合中多个文档中某个字段包含的所有唯一值。
样本数据
本指南中的示例使用 Atlas示例数据集中的sample_restaurants.restaurants
集合。 要学习;了解如何创建免费的MongoDB Atlas 群集并加载示例数据集,请参阅快速入门。
本页上的示例使用以下 Restaurant
类对集合中的文档进行建模:
public class Restaurant { public ObjectId? Id { get; set; } [ ] public string? Name { get; set; } [ ] public string? Cuisine { get; set; } [ ] public string? Borough { get; set; } }
Retrieve Distinct Values
要检索指定字段的非重复值,请调用 IMongoCollection<TDocument>
实例的 Distinct()
或 DistinctAsync()
方法,并传递要查找其非重复值的字段的名称。
检索集合中的值
以下示例检索 restaurants
集合中 borough
字段的非重复值。选择 Asynchronous 或 Synchronous标签页以查看相应的代码。
var results = await collection.DistinctAsync<string>(r => r.Borough, Builders<Restaurant>.Filters.Empty); await results.ForEachAsync(result => Console.WriteLine(result));
Bronx Brooklyn Manhattan Missing Queens Staten Island
var results = collection.Distinct<string>(r => r.Borough, Builders<Restaurant>.Filters.Empty).ToList(); foreach (var result in results) { Console.WriteLine(result); }
Bronx Brooklyn Manhattan Missing Queens Staten Island
该操作会返回一个游标,您可以遍历该游标以访问权限每个不同的 borough
字段值。尽管多个文档在 borough
字段中具有相同的值,但每个值仅在结果中出现一次。
检索指定文档中的值
您可以为Distinct()
和DistinctAsync()
方法提供查询过滤,以在集合的文档子集中查找不同的字段值。查询过滤是一个表达式,用于指定在操作中匹配文档的搜索条件。有关创建查询过滤的更多信息,请参阅“指定查询”指南。
以下示例检索 cuisine
字段值为 "Italian"
的所有文档的 borough
字段的非重复值。选择 Asynchronous 或 Synchronous标签页以查看相应的代码。
var filter = Builders<Restaurant>.Filter.Eq(r => r.Cuisine, "Italian"); var results = await collection.DistinctAsync<string>(r => r.Borough, filter); await results.ForEachAsync(result => Console.WriteLine(result));
Bronx Brooklyn Manhattan Queens Staten Island
var filter = Builders<Restaurant>.Filter.Eq(r => r.Cuisine, "Italian"); var results = collection.Distinct<string>(r => r.Borough, filter).ToList(); foreach (var result in results) { Console.WriteLine(result); }
Bronx Brooklyn Manhattan Queens Staten Island
修改不同行为
您可以通过提供 DistinctOptions
实例作为可选参数来修改 Distinct()
和 DistinctAsync()
方法的行为。下表描述了您可以在 DistinctOptions
实例上设立的属性:
方法 | 说明 |
---|---|
| Sets the collation to use for the operation. Data type: Collation |
| Sets the maximum amount of time that the operation can run. Data type: TimeSpan |
| Attaches a comment to the operation. Data type: BsonValue or string |
以下示例检索 borough
字段值为 "Bronx"
且 cuisine
字段值为 "Pizza"
的所有文档的 name
字段的非重复值。然后,它通过为 Distinct()
方法提供 DistinctOptions
实例来为操作添加注释。
选择 Asynchronous 或 Synchronous 标签页,查看相应的代码。
var cuisineFilter = Builders<Restaurant>.Filter.Eq(r => r.Cuisine, "Pizza"); var boroughFilter = Builders<Restaurant>.Filter.Eq(r => r.Borough, "Bronx"); var filter = Builders<Restaurant>.Filter.And(cuisineFilter, boroughFilter); var options = new DistinctOptions { Comment = "Find all Italian restaurants in the Bronx" }; var results = await collection.DistinctAsync<string>(r => r.Name, filter, options); await results.ForEachAsync(result => Console.WriteLine(result));
$1.25 Pizza 18 East Gunhill Pizza 2 Bros Aenos Pizza Alitalia Pizza Restaurant Amici Pizza And Pasta Angie'S Cafe Pizza ...
var cuisineFilter = Builders<Restaurant>.Filter.Eq(r => r.Cuisine, "Pizza"); var boroughFilter = Builders<Restaurant>.Filter.Eq(r => r.Borough, "Bronx"); var filter = Builders<Restaurant>.Filter.And(cuisineFilter, boroughFilter); var options = new DistinctOptions { Comment = "Find all Italian restaurants in the Bronx" }; var results = collection.Distinct<string>(r => r.Name, filter).ToList(); foreach (var result in results) { Console.WriteLine(result); }
$1.25 Pizza 18 East Gunhill Pizza 2 Bros Aenos Pizza Alitalia Pizza Restaurant Amici Pizza And Pasta Angie'S Cafe Pizza ...
API 文档
要进一步了解本指南所讨论的任何方法或类型,请参阅以下 API 文档: