/ /

Início rápido

Este guia mostra como criar um aplicativo que utiliza o .NET/C# Driver para conectar a um cluster do MongoDB Atlas. Se você preferir se conectar ao MongoDB usando um driver ou linguagem de programação diferente, consulte nossa lista de drivers oficiais do MongoDB.

O driver .NET/C# permite que você se conecte e comunique com clusters MongoDB a partir de um aplicativo .NET.

O MongoDB Atlas é um serviço de banco de dados em nuvem totalmente gerenciado que hospeda seus dados em clusters MongoDB. Neste guia, mostramos como começar a usar seu próprio cluster gratuito (nenhum cartão de crédito necessário).

Siga as etapas abaixo para conectar seu aplicativo .NET a um cluster MongoDB Atlas.

Criar um cluster MongoDB

Configurar um cluster de camada grátis no Atlas

Para definir o Atlas Free Tier Cluster necessário para este guia, complete o guia sobre MongoDB Atlas Setup.

Depois de concluir as etapas do guia do Atlas, você tem um novo cluster MongoDB implantado no Atlas, um novo usuário do banco de dados e conjuntos de dados de amostra carregados em seu cluster. Você também tem uma string de conexão semelhante à seguinte em seu buffer de cópia:

"mongodb+srv://<db_username>:<db_password>@cluster0.abc.mongodb.net/?retryWrites=true&w=majority"

Defina sua connection string

Execute o seguinte código na janela de comando para salvar sua string de conexão do MongoDB em uma variável de ambiente. Este método é mais seguro do que incluir as suas credenciais no seu código-fonte.

export MONGODB_URI="<your MongoDB URI>"

Observação

Variáveis de ambiente do PowerShell

Se estiver usando o Microsoft PowerShell, execute o seguinte comando para salvar sua string de conexão em uma variável de ambiente:

set MONGODB_URI="<your MongoDB URI>"

Importante

Certifique-se de substituir as seções <db_username> e <db_password> da string de conexão pelo nome de usuário e senha do seu usuário do banco de dados Atlas.

Para obter mais informações sobre strings de conexão, consulte Strings de conexão.

Configurar seu projeto

Criar o projeto

Crie um novo diretório e inicialize seu projeto com o comando dotnet new, como segue:

mkdir csharp-quickstart
cd csharp-quickstart
dotnet new console

Adicionar MongoDB como dependência

Use o comando dotnet add para adicionar o driver .NET/C# ao seu projeto como uma dependência.

dotnet add package MongoDB.Driver

Consulte seu cluster MongoDB a partir de seu aplicativo

Copie e cole o seguinte código no arquivo Program.cs em seu aplicativo. Você pode optar por consultar documentos usando um BsonDocument ou um objeto antigo e popular (POCO). Selecione a aba correspondente para ver um exemplo de cada abordagem:

using MongoDB.Bson;
using MongoDB.Bson.IO;
using MongoDB.Driver;
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/pt-br/docs/drivers/csharp/current/get-started/create-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.ToJson(new JsonWriterSettings { Indent = true }));

using MongoDB.Bson;
using MongoDB.Bson.Serialization.Attributes;
using MongoDB.Driver;
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/pt-br/docs/drivers/csharp/current/get-started/create-connection-string");
    Environment.Exit(0);
}
var client = new MongoClient(connectionString);
var collection = client.GetDatabase("sample_mflix").GetCollection<Movie>("movies");
var filter = Builders<Movie>.Filter.Eq(m => m.Title, "Back to the Future");
var movie = collection.Find(filter).First();
Console.WriteLine($"Title: {movie.Title}");
Console.WriteLine($"Plot: {movie.Plot}");
Console.WriteLine($"Genres: {string.Join(", ", movie.Genres ?? [])}");
[BsonIgnoreExtraElements]
public class Movie
{
    [BsonId]
    public ObjectId Id { get; set; }
    [BsonElement("title")]
    public string? Title { get; set; }
    [BsonElement("plot")]
    public string? Plot { get; set; }
    [BsonElement("genres")]
    public List<string>? Genres { get; set; }
}

Dica

Para saber mais sobre como usar POCOs com o driver .NET/C#, consulte o guia POCOs.

Execute o aplicativo na linha de comando usando o seguinte comando:

dotnet run csharp-quickstart.csproj

A saída inclui detalhes do documento de filme recuperado . Veja a seguir o resultado de cada abordagem:

{
  _id: ...,
  plot: 'A young man is accidentally sent 30 years into the past...',
  genres: [ 'Adventure', 'Comedy', 'Sci-Fi' ],
  ...
  title: 'Back to the Future',
  ...
}

Title: Back to the Future
Plot: A young man is accidentally sent 30 years into the past...
Genres: Adventure, Comedy, Sci-Fi

Dica

Se você encontrar um erro ou não vir nenhuma saída, verifique se especificou a string de conexão adequada e se carregou os dados de amostra.

Depois de concluir esta etapa, você terá um aplicativo funcional que usa o driver .NET/C# para se conectar ao cluster MongoDB, executar uma query nos dados de amostra e imprimir o resultado.

Para saber mais sobre como conectar ao Atlas com o Driver .NET/C#, consulte o guia Conexão de driver do Atlas e selecione C# no menu suspenso Select your language.

Próximos passos

Saiba como ler e modificar dados com o driver.NET/C# no guia de operações CRUD ou como executar operações comuns em Exemplos de uso.

Voltar

Visão geral

Referência rápida