/ /

Inicio rápido

Esta guía te muestra cómo crear una aplicación que utilice el Driver .NET/C# para conectarse a un clúster de MongoDB Atlas. Si prefiere conectarse a MongoDB usando un driver o lenguaje de programación diferente, consulte nuestra lista de controladores 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

Ejecute el siguiente código en el símbolo del sistema para guardar su cadena de conexión de MongoDB en 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úrate de reemplazar las secciones <db_username> y <db_password> 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

Copie y pegue el siguiente código en el archivo Program.cs de su aplicación. Puedes elegir query documentos utilizando un BsonDocument o un "objeto CLR Antiguo" (POCO). Selecciona la pestaña correspondiente para ver un ejemplo de cada enfoque:

using MongoDB.Bson;
using MongoDB.Bson.IO;
using MongoDB.Driver;
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/get-started/create-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.ToJson(new JsonWriterSettings { Indent = true }));

using MongoDB.Bson;
using MongoDB.Bson.Serialization.Attributes;
using MongoDB.Driver;
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/get-started/create-connection-string");
    Environment.Exit(0);
}
var client = new MongoClient(connectionString);
var collection = client.GetDatabase("sample_mflix").GetCollection<Movie>("movies");
var filter = Builders<Movie>.Filter.Eq(m => m.Title, "Back to the Future");
var movie = collection.Find(filter).First();
Console.WriteLine($"Title: {movie.Title}");
Console.WriteLine($"Plot: {movie.Plot}");
Console.WriteLine($"Genres: {string.Join(", ", movie.Genres ?? [])}");
[BsonIgnoreExtraElements]
public class Movie
{
    [BsonId]
    public ObjectId Id { get; set; }
    [BsonElement("title")]
    public string? Title { get; set; }
    [BsonElement("plot")]
    public string? Plot { get; set; }
    [BsonElement("genres")]
    public List<string>? Genres { get; set; }
}

Tip

Para obtener más información sobre cómo utilizar POCOs con el Driver .NET/C#, consulta la guía POCOs.

Ejecute la aplicación desde la línea de comandos con el siguiente comando:

dotnet run csharp-quickstart.csproj

La salida incluye detalles del documento de la película recuperada. A continuación, se muestra el resultado de cada enfoque:

{
  _id: ...,
  plot: 'A young man is accidentally sent 30 years into the past...',
  genres: [ 'Adventure', 'Comedy', 'Sci-Fi' ],
  ...
  title: 'Back to the Future',
  ...
}

Title: Back to the Future
Plot: A young man is accidentally sent 30 years into the past...
Genres: Adventure, Comedy, Sci-Fi

Tip

Si encuentras un error o no ves ninguna salida, asegúrate de haber especificado la cadena de conexión correcta y de haber cargado los datos de muestra.

Después de completar este paso, tendrá una aplicación funcional que utiliza el driver de .NET/C# para conectarse a su clúster de MongoDB, ejecutar una query en los datos de muestra e imprimir el resultado.

Para aprender más sobre cómo conectarse a Atlas usando el driver de .NET/C#, consulta la guía de conexión del driver de Atlas y selecciona C# en 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.

Volver

Overview

Referencia rápida