Docs 菜单

Docs 主页 → 开发应用程序 → MongoDB 驱动程序 → C#/.NET

快速入门

在此页面上

  • 创建 MongoDB 集群
  • 在 Atlas 中设置免费级集群
  • 设置连接字符串
  • 设置您的项目
  • 创建项目
  • 添加 MongoDB 作为依赖项
  • 从应用程序查询 MongoDB 集群
  • 后续步骤

本指南向您展示如何创建使用.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://<username>:<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>"

重要

确保用 Atlas 用户的用户名和密码替换连接字符串中的 <username> 和 <password> 部分。

有关连接字符串的更多信息，请参阅连接字符串。

设置您的项目

创建项目

创建一个新目录并使用 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 集群，然后在样本数据上运行查询。

打开项目基本目录中名为 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# 驱动程序读取和修改数据， 或者在使用示例中了解如何执行常见操作。

← 以前版本
快速参考 →

在此页面上