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 su clúster Atlas de nivel gratuito necesario para esta guía, complete la guía sobre configuración de MongoDB Atlas.
Tras completar los pasos de la guía de Atlas, tendrá un nuevo clúster de MongoDB implementado en Atlas, un nuevo usuario de base de datos y conjuntos de datos de muestra cargados en el clúster. También tendrá una cadena de conexión similar a la siguiente en el búfer de copia:
"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 deconexión a una variable de entorno. Este método es más seguro que incluir las credenciales en el 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
Cree un nuevo directorio e inicialice su proyecto con el comando dotnet new, de la siguiente manera:
mkdir csharp-quickstart cd csharp-quickstart dotnet new console
Agregar MongoDB como una dependencia
Utilice el comando dotnet add para agregar el controlador .NET/C# a su proyecto como una 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 ejemplo ejecuta una consulta en su conjunto de datos de ejemplo en MongoDB Atlas. Ejecútelo desde la línea de comandos con el siguiente comando:
dotnet run csharp-quickstart.csproj
Al ejecutar 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 cómo conectarse a Atlas con el controlador .NET/C#, consulte la guía de conexión del controlador Atlas y seleccione C# desde el menú 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.