Esta guía le muestra cómo crear una aplicación que usa el controlador .NET/C# para conectarse a un clúster de MongoDB Atlas. Si prefiere conectarse a MongoDB con un controlador o lenguaje de programación diferente, consulte nuestra Lista de controladores oficiales de MongoDB.
El controlador .NET/C# le permite conectarse y comunicarse con clústeres 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"
Establezca su cadena de conexión
Ejecute el siguiente código en el símbolo del sistema para guardar su 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 está utilizando Microsoft PowerShell, ejecute el siguiente comando para guardar la 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 su usuario de base de datos Atlas.
Para obtener más información sobre las cadenas de conexión, consulte 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, usará el controlador .NET/C# para conectarse a su clúster de MongoDB y ejecutar una consulta con los datos de muestra. Necesitará tener instalado y en ejecución su editor de texto o entorno de desarrollo integrado (IDE) preferido.
Abra el archivo Program.cs en el directorio base de su proyecto. Copie el siguiente código de ejemplo 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ía tener una aplicación en funcionamiento que use el controlador .NET/C# para conectarse a su clúster MongoDB, ejecutar una consulta en los datos de muestra e imprimir 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.