Overview
Los ejemplos de uso ofrecen puntos de partida prácticos para operaciones comunes de MongoDB. Cada ejemplo proporciona la siguiente información:
Un fragmento de código que muestra cómo realizar la operación en marcos sincrónicos y asincrónicos
Un enlace a una aplicación de consola completamente ejecutable que utiliza la operación
El resultado esperado después de ejecutar el ejemplo
Tip
El uso de un marco síncrono o asíncrono en su aplicación depende de su caso de uso. Las llamadas síncronas son más adecuadas para flujos de trabajo de consultas simples o cuando se requiere implementar lógica secuencial. Considere el uso de llamadas asíncronas si su aplicación depende de múltiples solicitudes simultáneas a la base de datos o si su programa no requiere una respuesta inmediata de la base de datos para continuar su ejecución.
Animamos a experimentar con ambos enfoques para determinar el marco más adecuado para tus propósitos.
Cómo utilizar los ejemplos de uso
Estos ejemplos utilizan el Conjuntos de datos de muestra proporcionados por Atlas. Puede cargarlos en su base de datos en la versión gratuita de MongoDB Atlas siguiendo la Guía de introducción a Atlas o importar el conjunto de datos de muestra a una instancia local de MongoDB.
Una vez que haya importado el conjunto de datos, puede copiar y pegar un ejemplo de uso en el entorno de desarrollo que prefiera. Puede seguir las instrucciones. Guía de inicio rápido para aprender a usar el controlador MongoDB.NET/C#. Una vez que haya copiado un ejemplo de uso, deberá editar la URI de conexión para conectar el ejemplo a su instancia de MongoDB:
// Replace the following with your MongoDB deployment's connection string. private static string _mongoConnectionString = "<connection string>";
Para obtener más información sobre cómo conectarse a su instancia de MongoDB, consulte la Guía de conexión.
Clases de ejemplo
Los ejemplos de uso en esta sección muestran cómo realizar operaciones en documentos en el restaurants Colección. Los ejemplos utilizan las siguientes clases Restaurant, Address y GradeEntry para modelar los datos de esta colección:
public class Restaurant { public ObjectId Id { get; set; } public string Name { get; set; } [] public string RestaurantId { get; set; } public string Cuisine { get; set; } public Address Address { get; set; } public string Borough { get; set; } public List<GradeEntry> Grades { get; set; } }
public class Address { public string Building { get; set; } [] public double[] Coordinates { get; set; } public string Street { get; set; } [] public string ZipCode { get; set; } }
public class GradeEntry { public DateTime Date { get; set; } public string Grade { get; set; } public float? Score { get; set; } }
Nota
Los documentos de la colección restaurants utilizan la convención de nomenclatura snake-case. Los ejemplos de esta guía utilizan un ConventionPack para deserializar los campos de la colección en notación Pascal y asignarlos a las propiedades de la clase Restaurant.
Para aprender más sobre la serialización personalizada, consultar Serialización personalizada.