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

Crea un directorio de proyecto.

En su shell, ejecute los siguientes comandos para crear un directorio llamado csharp-quickstart e inicializar un proyecto de .NET framework 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

Cree 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 su cadena de conexión para la implementación que creó en el paso anterior, inicie sesión en su cuenta de Atlas y navegue hasta la Clusters Página en la sección Database. Haga clic en el botón Connect para su 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.

Cree su aplicación .NET/C#.

Copie y pegue el siguiente código en el archivo Program.cs de su aplicación:

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 }));

Ejecute su aplicación.

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

dotnet run csharp-quickstart.csproj

El resultado incluye detalles del documento de película recuperado:

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