快速入门
本指南向您展示如何创建使用 .NET/C# 驱动程序连接到 MongoDB Atlas 集群的应用程序。如果希望使用其他驱动程序或编程语言连接 MongoDB,请参阅我们的 MongoDB 官方驱动程序列表。
.NET/C# 驱动程序允许您从 .NET/C# 应用程序连接到 MongoDB 集群并与之通信。
MongoDB Atlas 是完全托管的云数据库服务,可在 MongoDB 集群托管数据。 在本指南中,我们将向您介绍 如何开始使用自己的免费(无需信用卡)集群。
按照以下步骤将 .NET 应用程序与 MongoDB Atlas 集群进行连接。
创建 MongoDB 集群
在 Atlas 中设置免费级集群
如需设置本指南所需的“Atlas 免费层级集群”,请完成 MongoDB Atlas 设置指南。
完成 Atlas 指南中的步骤后,您就在 Atlas 中部署了一个新的 MongoDB 集群、一个新的数据库用户,并将样本数据集加载到集群中。复制缓冲区中还有一个类似于以下内容的连接字符串:
"mongodb+srv://<db_username>:<db_password>@cluster0.abc.mongodb.net/?retryWrites=true&w=majority"
设置连接字符串
在命令提示符下运行以下代码,将 MongoDB 连接字符串保存到环境变量中。此方法比将档案包含在源代码中更安全。
export MONGODB_URI="<your MongoDB URI>"
注意
PowerShell 环境变量
如果使用的是 Microsoft PowerShell,请运行以下命令,将连接字符串保存在环境变量中:
set MONGODB_URI="<your MongoDB URI>"
重要
确保将连接字符串中的 <db_username>
和<db_password>
部分替换为您的 Atlas 数据库用户的用户名和密码。
有关连接字符串的更多信息,请参阅连接字符串。
设置您的项目
创建项目
创建一个新目录并使用 dotnet new
命令初始化项目,如下所示:
mkdir csharp-quickstart cd csharp-quickstart dotnet new console
添加 MongoDB 作为依赖项
使用 dotnet add
命令将 .NET/C# 驱动程序作为依赖项添加到项目中。
dotnet add package MongoDB.Driver
从应用程序查询 MongoDB 集群
在这一步骤中,您将使用 .NET/C# 驱动程序连接您的 MongoDB 集群,然后在示例数据上运行查询。您需要安装并运行您首选的文本编辑器或集成开发环境 (IDE)。
打开项目基本目录中名为 Program.cs
的文件。将以下样本代码复制到 Program.cs
using MongoDB.Driver; using MongoDB.Bson; var connectionString = Environment.GetEnvironmentVariable("MONGODB_URI"); if (connectionString == null) { Console.WriteLine("You must set your 'MONGODB_URI' environment variable. To learn how to set it, see https://www.mongodb.com/zh-cn/docs/drivers/csharp/current/quick-start/#set-your-connection-string"); Environment.Exit(0); } var client = new MongoClient(connectionString); var collection = client.GetDatabase("sample_mflix").GetCollection<BsonDocument>("movies"); var filter = Builders<BsonDocument>.Filter.Eq("title", "Back to the Future"); var document = collection.Find(filter).First(); Console.WriteLine(document);
此示例代码针对 MongoDB Atlas 中的示例数据集运行查询。 在命令行中,使用以下命令运行它:
dotnet run csharp-quickstart.csproj
当您运行 Program.cs
时,它应从示例数据集中输出以下电影的详细信息:
{ "_id": "573a1398f29313caabce9682", ... "title": "Back to the Future", ... }
提示
如果输出为空,请确保已将样本数据集加载到集群中。
完成此步骤后,您便应有一个正常运行的应用程序, 它会使用 .NET/C# 驱动程序连接到 MongoDB 集群、 对样本数据运行查询并打印结果。
要了解有关使用 .NET/C# 驱动程序连接到 Atlas 的更多信息,请参阅 Atlas 驱动程序连接指南,然后从 Select your language 下拉列表中选择 C#。
后续步骤
在增删改查操作指南中了解如何使用 .NET/C# 驱动程序读取和修改数据, 或者在使用示例中了解如何执行常见操作。