Introdução ao driver .NET/C#

Criar uma diretoria de projeto

Em sua shell, execute os seguintes comandos para criar um diretório chamado csharp-quickstart e inicializar um projeto de framework .NET para um novo aplicação de console :

mkdir csharp-quickstart
cd csharp-quickstart
dotnet new console

Instale o driver .NET/C#

Execute o seguinte comando para instalar a versão atual do driver .NET/C# como uma dependência do seu projeto:

dotnet add package MongoDB.Driver

Criar um MongoDB deployment gratuito no Atlas

Complete o guia Iniciar com Atlas para configurar uma nova conta Atlas e carregar dados de amostra em uma nova implantação MongoDB de camada gratuita.

Salvar suas credenciais

Depois de criar o usuário do banco de dados, salve o nome de usuário e a senha desse usuário em um local seguro para uso em uma próxima etapa.

Encontre sua connection string do MongoDB Atlas

Para recuperar a string de conexão da implantação criada na etapa anterior, faça login na sua conta do Atlas e navegue até a seção Database e clique no botão Connect para a nova implantação.

Vá para a seção Connect your application e selecione "C# / .NET" no menu de seleção Driver e a versão que melhor corresponde à versão instalada no menu de seleção Version.

Selecione o mecanismo de autenticação Password (SCRAM).

Desmarque a opção Include full driver code example para visualizar a string de conexão.

Copie a connection string

Clique no botão à direita da string de conexão para copiá-la para a área de transferência, como mostrado na seguinte captura de tela:

Atualizar os espaços reservados

Cole esta connection string em um arquivo no editor de texto de sua preferência e substitua os placeholders <db_username> e <db_password> pelo seu nome de usuário e senha de utilizador de banco de dados.

Salve este arquivo em um local seguro para uso na próxima etapa.

Definir uma variável de ambiente

Em seu shell, execute o seguinte código para salvar sua string de conexão MongoDB em uma variável de ambiente. Substitua <your MongoDB URI> pela string de conexão que você salvou em um arquivo na etapa anterior.

export MONGODB_URI="<your MongoDB URI>"

set MONGODB_URI="<your MongoDB URI>"

Armazenar suas credenciais em uma variável de ambiente é mais seguro do que codificá-las em seu código-fonte.

Crie seu aplicativo .NET/C#

Copie e cole o seguinte código no arquivo Program.cs em seu aplicativo:

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/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);

Execute seu aplicativo

Em sua shell, execute o seguinte comando para iniciar este aplicativo:

dotnet run csharp-quickstart.csproj

A saída inclui detalhes do documento de filme recuperado:

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