En esta guía, se muestra cómo conectarse a una instancia de MongoDB o a una implementación de un set de réplicas mediante el driver .NET/C#.
Overview
Para conectarte a una implementación de MongoDB, necesitas los siguientes componentes:
URI de conexión, también conocido como cadena de conexión, que le indica al .NET/C# Driver a qué implementación de MongoDB debe conectarse.
El objeto MongoClient, que crea y mantiene la conexión a la implementación de MongoDB y te permite realizar operaciones de datos.
También puedes especificar la configuración de conexión en cualquiera de estos componentes para personalizar la forma en que se comporta el driver .NET/C# mientras estás conectado a MongoDB.
Esta guía le muestra cómo crear una URI de conexión y utilizar una MongoClient objeto para conectarse a MongoDB.
URI de conexión
Un URI de conexión estándar incluye los siguientes componentes:
Componente | Descripción |
|---|---|
| Requerido. Un prefijo que identifica esto como un string en el formato de conexión estándar. |
| Opcional. Credenciales de autenticación. Si las incluye, el cliente autentica al usuario en la base de datos especificada en |
| Requerido. El host y el número de puerto opcional donde se ejecuta MongoDB. Si no se incluye el número de puerto, el driver utiliza el puerto por defecto, |
| Opcional. La base de datos de autenticación que se debe usar si la cadena de conexión incluye las credenciales de autenticación |
| Opcional. Un string del query que especifica opciones específicas de conexión como pares |
Para obtener más información sobre cómo crear una cadena de conexión, consulte Cadenas de conexión en la documentación del servidor MongoDB.
MongoClient
Para crear una conexión a MongoDB, pasa un URI de conexión al constructor MongoClient. En el siguiente ejemplo, el controlador utiliza un URI de conexión de muestra para conectarse a una implementación de MongoDB que se ejecuta en el puerto 27017 de localhost:
const string uri = "mongodb://localhost:27017/"; var client = new MongoClient(uri);
Gestiona los elementos descartables de MongoClient
Cuando uses MongoClient, te recomendamos que le des un alcance de vida singleton. Sin embargo, esto podría generar un uso excesivo de memoria y recursos no utilizados.
En v3.0 y versiones posteriores del driver .NET/C#, un nuevo MongoClient implementa IDisposable para liberar recursos mientras se utiliza un alcance de vida singleton. Esta implementación permite que la clase MongoClient y cualquier clase que implemente la interfaz IMongoClient accedan a un método Dispose(). Después de que elimines al cliente, cualquier conexión de nodo devuelve un error ObjectDisposedException.
Eliminar MongoClient no elimina el clúster ni las conexiones subyacentes. Para deshacerte de estos recursos, llama a ClusterRegistry.UnregisterAndDisposeCluster(). Para aprender más sobre el método ClusterRegistry.UnregisterAndDisposeCluster(), consulta UnregisterAndDisposeCluster() en la documentación de la API del driver .NET/C#.
Configura la conexión
Puedes configurar tu conexión de las siguientes maneras:
Especificar parámetros en el URI de conexión
Especificar la configuración de un objeto
MongoClientSettingsoMongoUrlBuilder
Para aprender más sobre cómo configurar tu conexión, consulta la guía Especificar opciones de conexión.
Documentación de la API
Para obtener más información sobre cómo crear un objeto MongoClient con el driver .NET/C#, consulta la siguiente documentación de la API.