Criar um MongoClient

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
`mongodb://`	Obrigatório. Um prefixo que identifica isso como uma string no formato de conexão padrão.
`username:password`	Opcional. Credenciais de autenticação. Se você incluir estes, o cliente autenticará o usuário no banco de dados especificado no `authSource`. Para mais informações sobre configurações de autenticação, consulteMecanismos de Autenticaçãodo .
`host[:port]`	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 `27017`.
`/defaultauthdb`	Opcional. O authentication database de autenticação a ser usado se a connection string incluir as credenciais de autenticação `username:password@` , mas não a opção `authSource` . Se você não incluir este componente, o cliente autenticará o usuário no banco de dados do `admin` .
`?<options>`	Opcional. Uma string de consulta que especifica opções específicas de conexão como `<name>=<value>` pares. Consulte Especificar opções de conexão para obter uma descrição completa dessas opções.

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

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 MongoClientSettings ou MongoUrlBuilder

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:

Voltar

Conecte

Escolha um destino de conexão