快速入门

在本页

创建 MongoDB 集群

在 Atlas 中设置免费层集群
设置您的连接字符串
设置您的项目
创建项目
将 MongoDB 添加为依赖项
从您的应用程序查询 MongoDB 集群
下一步

本指南向您展示如何创建一个使用 .NET/C# 驱动程序 连接到 MongoDB Atlas 集群 的应用程序。如果您希望使用不同的驱动程序或编程语言连接到 MongoDB，请参阅我们官方 MongoDB 驱动程序列表.

.NET/C# 驱动程序让您可以从 .NET 应用程序连接到并与 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://mongodb.ac.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驱动程序连接指南，并在下拉菜单中选择C# 从选择您的语言下拉菜单。

下一步操作

在CRUD操作指南中学习如何使用.NET/C#驱动程序读取和修改数据，或在用法示例中了解如何执行常见操作。

以前版本

下一步

快速参考