Este guia mostra como se conectar a uma instância MongoDB ou implantação de conjunto de réplica usando o Driver .NET/C#.
Visão geral
A conexão a um sistema do MongoDB requer os seguintes componentes:
URI de conexão, também conhecido como string de conexão, que informa ao driver .NET/C# a qual sistema do MongoDB se conectar.
objeto MongoClient, que cria e sustenta a conexão com o sistema do MongoDB e permite que você execute operações de dados.
Você também pode especificar as configurações de conexão em qualquer um desses componentes para personalizar a forma como o driver .NET/C# se comporta enquanto conectado ao MongoDB.
Este guia mostra como criar um URI de conexão e utilizar um objeto MongoClient para conectar ao MongoDB.
URI de conexão
Um URI de conexão padrão inclui os seguintes componentes:
Componente | Descrição |
|---|---|
| Obrigatório. Um prefixo que identifica isso como uma string no formato de conexão padrão. |
| Opcional. Credenciais de autenticação. Se você incluir estes, o cliente autenticará o usuário no banco de dados especificado no |
| Obrigatório. O host e o número da porta opcional em que o MongoDB está sendo executado. Se você não incluir o número da porta, o driver usará a porta padrão |
| Opcional. O authentication database de autenticação a ser usado se a connection string incluir as credenciais de autenticação |
| Opcional. Uma string de consulta que especifica opções específicas de conexão como |
Para obter mais informações sobre a criação de uma connection string, consulte connection strings na documentação do MongoDB Server .
Cliente Mongo
Para criar uma conexão com o MongoDB, passe um URI de conexão para o construtor MongoClient. No exemplo a seguir, o driver usa um URI de conexão de exemplo para se conectar a uma implementação do MongoDB em execução na porta 27017 de localhost:
const string uri = "mongodb://localhost:27017/"; var client = new MongoClient(uri);
Gerenciar descartáveis do MongoClient
Quando você usa MongoClient, recomendamos atribuir a ele um escopo de vida útil único. No entanto, isso pode causar uso excessivo de memória e recursos não descartados.
Na versão3.0 e posterior do driver .NET/C#, um novo MongoClient implementa IDisposable para descartar recursos enquanto usa um escopo de vida útil singleton. Essa implementação permite que a classe MongoClient e quaisquer classes que implementem a interface IMongoClient acessem um método Dispose(). Depois de descartar o cliente, todas as conexões de membro retornarão um erro ObjectDisposedException .
O descarte de MongoClient não descarta o cluster e as conexões subjacentes. Para descartar esses recursos, ligue ClusterRegistry.UnregisterAndDisposeCluster() para. Para saber mais sobre o ClusterRegistry.UnregisterAndDisposeCluster() método, consulte UnregisterAndDisposeCluster() na documentação da API do driver .NET/C#.
Configurar a conexão
Você pode configurar sua conexão das seguintes maneiras:
Especificando parâmetros no URI de conexão
Especificando configurações em um objeto
MongoClientSettingsouMongoUrlBuilder
Para saber mais sobre como configurar sua conexão, consulte o guia Especificar opções de conexão.
Documentação da API
Para saber mais sobre como criar um objeto MongoClient com o driver .NET/C#, consulte a seguinte documentação da API: