Menu Docs
Página inicial do Docs
/
Idiomas
/
C#/.NET
/
C#/.NET

Início rápido

Nesta página

  • Criar um cluster MongoDB
  • Configurar um cluster de camada grátis no Atlas
  • Defina sua connection string
  • Configurar seu projeto
  • Criar o projeto
  • Adicionar MongoDB como dependência
  • Consulte seu cluster MongoDB a partir de seu aplicativo
  • Próximos passos

Este guia mostra como criar um aplicativo que usa o driver .NET/C# para se conectar a um cluster do MongoDB Atlas. Se você preferir se conectar ao MongoDB usando um driver ou uma linguagem de programação diferente, consulte nossa listade 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

Nesta etapa, você usará o driver .NET/C# para se conectar ao cluster MongoDB e executar uma query sobre os dados de amostra. Você precisará do seu editor de texto ou ambiente de desenvolvimento integrado (IDE) preferido instalado e em execução.

Abra o arquivo denominado Program.cs no diretório de base do seu projeto. Copie o código de exemplo a seguir em 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/pt-br/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);

Este código de amostra executa uma query em relação ao seu conjunto de dados da amostra no MongoDB Atlas. Execute-o na linha de comando usando o seguinte comando:

dotnet run csharp-quickstart.csproj

Quando você executar o Program.cs, ele deverá produzir os detalhes do seguinte filme a partir do conjunto de dados de amostra:

{
    "_id": "573a1398f29313caabce9682",
    ...
    "title": "Back to the Future",
    ...
}

Dica

Se a saída estiver vazia, verifique se você carregou os conjuntos de dados de exemplo no cluster.

Depois de concluir esta etapa, você deve ter um aplicativo funcional que use 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

Versões anteriores

Próximo

Referência rápida