使用示例
Overview
用法示例为常用 MongoDB 操作提供了便捷起点。 每个示例都提供了以下信息:
显示如何在同步和异步框架中执行操作的代码片段
使用操作指向完全可运行的控制台应用程序的链接
运行示例后的预期结果
提示
在应用程序中使用同步框架还是异步框架取决于您的用例。同步调用更适合于简单的查询工作流或必须实现顺序逻辑的情况。如果您的应用程序依赖于多个并发数据库请求,或者您的程序不需要数据库立即响应即可继续执行,请考虑使用异步调用。
我们鼓励尝试这两种方法,以确定最适合您的框架。
如何使用用法示例
这些示例使用 Atlas 提供的 示例数据集。您可以按照 Atlas 入门指南将这些示例数据集加载到 MongoDB Atlas 免费套餐的数据库中,也可以将其导入本地 MongoDB 实例中。
导入数据集后,您可以复制用法示例,并将其粘贴到所选的开发环境中。 您可以按照快速入门,详细学习;了解如何开始使用MongoDB .NET/ C#驱动程序。 复制用法示例后,您需要编辑连接 URI 以使示例连接到MongoDB实例:
// Replace the following with your MongoDB deployment's connection string. private static string _mongoConnectionString = "<connection string>";
有关连接到 MongoDB 实例的更多信息,请参阅连接指南。
类示例
本节中的用法示例说明了如何对 restaurants
集合中的文档执行操作。这些示例使用以下 Restaurant
、Address
和GradeEntry
类对该集合中的数据进行建模:
public class Restaurant { public ObjectId Id { get; set; } public string Name { get; set; } [ ] public string RestaurantId { get; set; } public string Cuisine { get; set; } public Address Address { get; set; } public string Borough { get; set; } public List<GradeEntry> Grades { get; set; } }
public class Address { public string Building { get; set; } [ ] public double[] Coordinates { get; set; } public string Street { get; set; } [ ] public string ZipCode { get; set; } }
public class GradeEntry { public DateTime Date { get; set; } public string Grade { get; set; } public float? Score { get; set; } }
注意
restaurants
集合中的文档使用蛇形命名规则。本指南中的示例使用ConventionPack
将集合中的字段反序列化为 Pascal 语句,并将它们映射到Restaurant
类中的属性。
如需了解有关自定义序列化的更多信息,请参阅“自定义序列化”。