Retrieve Data

Datos de muestra

Los ejemplos de esta guía utilizan la colección sample_restaurants.restaurants de Conjuntos de datos de muestra de Atlas. Para aprender a crear un clúster gratuito de MongoDB Atlas y cargar los conjuntos de datos de muestra, consulte Introducción al controlador .NET/C#.

En los ejemplos de esta página se utilizan las siguientes clases Restaurant, Address y GradeEntry como modelos:

public class Restaurant
{
    public ObjectId Id { get; set; }
    public string Name { get; set; }
    [BsonElement("restaurant_id")]
    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; }
    [BsonElement("coord")]
    public double[] Coordinates { get; set; }
    public string Street { get; set; }
    [BsonElement("zipcode")]
    public string ZipCode { get; set; }
}

public class GradeEntry
{
    public DateTime Date { get; set; }
    public string Grade { get; set; }
    public float? Score { get; set; }
}

Encuentre un documento

Para buscar un solo documento en una colección, pasa un filtro de query que especifique los criterios del documento que deseas buscar y, a continuación, encadena el método FirstOrDefault() o FirstOrDefaultAsync(). Si más de un documento coincide con el filtro de query, estos métodos devuelven el primer documento coincidente de los resultados recuperados. Si ningún documento coincide con el filtro de query, los métodos devuelven null.

var restaurants = _restaurantsCollection.Find(filter).FirstOrDefault();

var restaurants = await _restaurantsCollection.Find(filter).FirstOrDefaultAsync();

Para ver un ejemplo completo de cómo usar el método Find() para encontrar un único documento, consulta la Información adicional.

Encuentra varios documentos

Para encontrar varios documentos en una colección, pasar un filtro de query al método Find() que especifique los criterios de los documentos que desea recuperar.

Se puede utilizar un cursor para iterar sobre los documentos devueltos por el método Find(). Un cursor es un mecanismo que permite a una aplicación iterar sobre los resultados de una base de datos mientras mantiene solo un subconjunto de ellos en la memoria en un momento dado. Los cursores son útiles cuando el método Find() devuelve una gran cantidad de documentos.

Si deseas utilizar un cursor para iterar sobre los documentos, pasa un filtro de query al método Find() que especifique los criterios de los documentos que quieras buscar y, a continuación, encadena el método ToCursor() o ToCursorAsync(). Para ver un ejemplo sincrónico o asincrónico, selecciona la pestaña correspondiente.

var restaurants = _restaurantsCollection.Find(filter).ToCursor();

var restaurants = await _restaurantsCollection.Find(filter).ToCursorAsync();

Si devuelves un pequeño número de documentos o necesitas que se devuelvan los resultados como un objeto List, utiliza los métodos ToList() o ToListAsync().

Para encontrar varios documentos en una colección y mantenerlos en la memoria como una lista, pasa un filtro de query al método Find() que especifique los criterios de los documentos que quieras encontrar y, a continuación, encadena el método ToList() o ToListAsync(). Para ver un ejemplo sincrónico o asincrónico, selecciona la pestaña correspondiente.

var restaurants = _restaurantsCollection.Find(filter).ToList();

var restaurants = await _restaurantsCollection.Find(filter).ToListAsync();

Para ver un ejemplo completo de cómo usar el método Find() para encontrar varios documentos, consulta la Información adicional.

var filter = Builders<Restaurant>.Filter.Empty;
var allRestaurants = _restaurantsCollection.Find(filter);

Modificar el comportamiento de búsqueda

Puedes modificar el comportamiento del método Find() pasando un objeto FindOptions.

Puedes configurar las opciones de uso común con los siguientes métodos:

Para ver una lista completa de las opciones disponibles, consulta Propiedades de FindOptions.

Intercalación

Para configurar la intercalación para tu operación, crea una instancia de la clase intercalación.

La siguiente tabla describe los parámetros que acepta el constructor Collation. También enumera la propiedad de clase correspondiente que se puede usar para leer el valor de cada configuración.

Más información sobre la intercalación en la página Intercalación en el manual de MongoDB Server.

Ejemplo

Este ejemplo realiza las siguientes acciones:

• Busca todos los documentos que contengan “Pizza” en el campo cuisine

• Establece el BatchSize en 3

• Almacena los resultados en un cursor

• Imprime los documentos a los que hace referencia el cursor

var filter = Builders<Restaurant>.Filter.Eq("cuisine", "Pizza");
var findOptions = new FindOptions { BatchSize = 3 };
using (var cursor = _restaurantsCollection.Find(filter, findOptions).ToCursor())
{
   foreach (var r in cursor.ToEnumerable())
   {
      WriteLine(r.Name);
   }
}

Pizza Town
Victoria Pizza
...

Documentación de la API

Para obtener más información sobre cualquiera de los métodos o tipos discutidos en esta guía, consultar la siguiente documentación de la API:

• find()

• FirstOrDefault()

• FirstOrDefaultAsync()

• FindOptions

• ToList()

• ToListAsync()

• ToCursor()

• ToCursorAsync()