Cómo comenzar con el controlador .NET/C#

Crea un directorio de proyecto.

En tu shell, ejecuta los siguientes comandos para crear un directorio llamado csharp-quickstart e inicializa un proyecto del framework .NET para una nueva aplicación de consola:

mkdir csharp-quickstart
cd csharp-quickstart
dotnet new console

Instale el controlador .NET/C#.

Ejecute el siguiente comando para instalar la versión actual del controlador .NET/C# como dependencia de su proyecto:

dotnet add package MongoDB.Driver

Crea una implementación gratuita de MongoDB en Atlas.

Completa la Guía de inicio de MongoDB para configurar una nueva cuenta de Atlas y cargar datos de muestra en una nueva implementación de MongoDB de nivel gratuito.

Guarda tus credenciales.

Después de crear un usuario de base de datos, guardar el nombre de usuario y la contraseña de ese usuario en una ubicación segura para usarlos en un paso próximo.

Encuentra tu cadena de conexión de MongoDB Atlas.

Para recuperar tu cadena de conexión para la implementación que creaste en el paso anterior, inicia sesión en tu cuenta de Atlas y navega hasta Clusters la página en la sección Database. Haz clic en el botón Connect para tu nueva implementación.

Si aún no tienes un usuario de base de datos configurado, MongoDB te pedirá que crees y configures un nuevo usuario.

Haga clic en el botón Drivers debajo de la sección Connect to your application y seleccione "C# / .NET" en el menú de selección Driver y la versión que mejor coincida con la versión que instaló en el menú de selección Version.

Asegúrate de que la opción View full code sample esté desmarcada para ver solo la cadena de conexión.

Copie su cadena de conexión.

Se debe hacer clic en el botón a la derecha de la cadena de conexión para copiarla al portapapeles, como se muestra en la siguiente captura de pantalla:

Actualiza el marcador de posición de la contraseña.

Pega esta cadena de conexión en un archivo en tu editor de texto preferido y reemplaza el marcador de posición <db_password> con la contraseña de tu usuario de base de datos. La cadena de conexión ya está completada con el nombre de usuario de tu usuario de base de datos.

Guarda este archivo en una ubicación segura para usarlo en el siguiente paso.

Establecer una variable de entorno.

En su shell, ejecute el siguiente código para guardar su cadena de conexión de MongoDB en una variable de entorno. Sustituya <your MongoDB URI> por la cadena de conexión que guardó en un archivo en el paso anterior.

export MONGODB_URI="<your MongoDB URI>"

set MONGODB_URI="<your MongoDB URI>"

Almacenar las credenciales en una variable de entorno es más seguro que codificarlas directamente en el código fuente.

Crea tu aplicación .NET/C#.

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.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/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; }
}

Ejecuta la aplicación.

En su shell, ejecute el siguiente comando para iniciar esta aplicación:

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