Esta guía te muestra cómo crear una aplicación que utiliza el Driver .NET/C# para conectarse a un clúster MongoDB Atlas. Si prefieres conectarte a MongoDB usando un controlador o lenguaje de programación diferente, consulta nuestro Lista de drivers oficiales de MongoDB.
El controlador .NET/C# permite conectarse y comunicarse con clústeres de MongoDB desde una aplicación .NET.
MongoDB Atlas es un servicio de base de datos en la nube completamente gestionada que aloja los datos en clústeres de MongoDB. En esta guía, mostramos cómo comenzar con un clúster gratuito (no se necesita tarjeta de crédito).
Siga los pasos a continuación para conectar su aplicación .NET con un clúster de MongoDB Atlas.
Crear un clúster de MongoDB
Configurar un clúster de nivel gratuito en Atlas
Para configurar el Clúster Atlas de Nivel gratuito requerido para esta guía, completa la guía en Configuración de MongoDB Atlas.
Después de completar los pasos en la guía de Atlas, tienes un nuevo clúster de MongoDB desplegado en Atlas, un nuevo usuario de base de datos y conjuntos de datos de ejemplo cargados en tu clúster. También tienes una cadena de conexión similar a la siguiente en tu portapapeles:
"mongodb+srv://<db_username>:<db_password>@cluster0.abc.mongodb.net/?retryWrites=true&w=majority"
Configura tu cadena de conexión
Ejecuta el siguiente código en el indicador de comandos para guardar tu MongoDB cadena de conexión a una variable de entorno. Este método es más seguro que incluir sus credenciales en su código fuente.
export MONGODB_URI="<your MongoDB URI>"
Nota
Variables de entorno de PowerShell
Si utiliza Microsoft PowerShell, ejecute el siguiente comando para guardar su cadena de conexión en una variable de entorno:
set MONGODB_URI="<your MongoDB URI>"
Importante
Asegúrese de reemplazar el <db_username> y <db_password> secciones de la cadena de conexión con el nombre de usuario y la contraseña de tu usuario de base de datos Atlas.
Para obtener más información sobre las cadenas de conexión, consulta Cadenas de conexión.
Configurar el proyecto
Crea el proyecto
Crea un nuevo directorio e inicializa tu proyecto con el comando dotnet new, de la siguiente manera:
mkdir csharp-quickstart cd csharp-quickstart dotnet new console
Agregar MongoDB como una dependencia
Utiliza el comando dotnet add para añadir el controlador .NET/C# a tu proyecto como dependencia.
dotnet add package MongoDB.Driver
Se debe realizar un query en el clúster de MongoDB desde la aplicación
En este paso, utilizarás el .NET/C# driver para conectarte a tu clúster de MongoDB y ejecutar una query en los datos de muestra. Necesitarás tener instalado y funcionando tu editor de texto preferido o un entorno de desarrollo integrado (IDE).
Abre el archivo denominado Program.cs en el directorio base de tu proyecto. Copia el siguiente código de muestra en 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/es/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 muestra ejecuta una query en el dataset de muestra en MongoDB Atlas. Ejecute el siguiente comando desde la línea de comandos:
dotnet run csharp-quickstart.csproj
Cuando ejecutes Program.cs, debería mostrar los detalles de la siguiente película del conjunto de datos de muestra:
{ "_id": "573a1398f29313caabce9682", ... "title": "Back to the Future", ... }
Tip
Si la salida está vacía, es importante asegurarse de haber cargado los conjuntos de datos de muestra en el clúster.
Después de completar este paso, deberías tener una aplicación funcional que utiliza el driver de .NET/C# para conectarse a tu clúster de MongoDB, ejecutar una query en los datos de muestra y mostrar el resultado.
Para obtener más información sobre la conexión a Atlas con el controlador .NET/C#, consulta la guía Conexión del driver de Atlas y selecciona C# desde la lista desplegable Select your language.
Próximos pasos
Aprenda a leer y modificar datos utilizando el controlador .NET/C# en la guía de operaciones CRUD o cómo realizar operaciones comunes en Ejemplos de uso.