Overview
Los ejemplos de uso proporcionan puntos de partida convenientes para las operaciones populares de MongoDB. Cada ejemplo proporciona la siguiente información:
Un snippet de código que muestra cómo realizar la operación en marcos síncronos y asíncronos
Un enlace a una aplicación de consola completamente ejecutable usando la operación
El resultado esperado después de ejecutar el ejemplo
Tip
Ya sea que utilices un framework sincrónico o asincrónico en tu aplicación depende de tu caso de uso. Las llamadas síncronas son más adecuadas para flujos de trabajo de query simples o cuando se debe implementar lógica secuencial. Considera usar llamadas asíncronas si tu aplicación depende de múltiples solicitudes concurrentes a la base de datos o si tu programa no requiere una respuesta inmediata de la base de datos para seguir ejecutándose.
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 usan el conjuntos de datos de muestra proporcionados por Atlas. Puedes cargarlos en tu base de datos en el nivel gratuito de MongoDB Atlas siguiendo los pasos en Comenzar a usar Atlas o puedes importar el conjunto de datos de muestra en una instancia local de MongoDB.
Una vez que hayas importado el conjunto de datos, puedes copiar y pegar un ejemplo de uso en el entorno de desarrollo de tu preferencia. Puedes seguir la Inicio rápido para aprender más sobre cómo comenzar con el controlador MongoDB .NET/C#. Una vez que hayas copiado un ejemplo de uso, deberás editar el URI de conexión para que el ejemplo se conecte con tu 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 en 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.