/ /

/ /

Librerías de clientes

Driver C#/.NET

Fundamentals

Lea

Contabilizar documentos

Overview

En esta guía, puedes aprender cómo obtener un preciso y estimado recuento del número de documentos en tu colección.

Datos de muestra

Los ejemplos en esta guía utilizan los siguientes documentos en una colección llamada students:

{ "_id": 1, "name": "Jonathon Howard ", "finalGrade": 87.5 }
{ "_id": 2, "name": "Keisha Freeman", "finalGrade": 12.3 }
{ "_id": 3, "name": "Wei Zhang", "finalGrade": 99.0 }
{ "_id": 4, "name": "Juan Gonzalez", "finalGrade": 85.5 }
{ "_id": 5, "name": "Erik Trout", "finalGrade": 72.3 }
{ "_id": 6, "name": "Demarcus Smith", "finalGrade": 88.8 }

La siguiente clase Student modela los documentos en esta colección:

public class Student {
    public int Id { get; set; }
    public string Name { get; set; }
    public double FinalGrade { get; set; }
}

Nota

Los documentos de la colección students utilizan la convención de nomenclatura camel case. En los ejemplos de esta guía, se utiliza un ConventionPack para deserializar los campos de la colección en notación Pascal y asignarlos a las propiedades de la clase Student.

Para obtener más información sobre la serialización personalizada, consulta Serialización personalizada.

Conteo preciso

Para contar el número de documentos que coinciden con su filtro de consulta, utilice el CountDocuments() método. Si pasa un filtro de consulta vacío, este método devuelve el número total de documentos de la colección.

Ejemplo

El siguiente ejemplo cuenta el número de documentos donde el valor de finalGrade es menor que 80:

var filter = Builders<Student>.Filter.Lt(s => s.FinalGrade, 80.0);
var count = _myColl.CountDocuments(filter);
Console.WriteLine("Number of documents with a final grade less than 80: " + count);

Number of documents with a final grade less than 80: 2

Modificar comportamiento

Puedes modificar el comportamiento de CountDocuments() pasando un tipo CountOptions como parámetro. Si no especifica ninguna opción, el driver utiliza valores por defecto.

Puedes establecer las siguientes propiedades en un objeto CountOptions:

Propiedad	Descripción
`Collation`	The type of language collation to use when sorting results. Default: `null`
`Hint`	The index to use to scan for documents to count. Default: `null`
`Limit`	The maximum number of documents to count. Default: `0`
`MaxTime`	The maximum amount of time that the query can run on the server. Default: `null`
`Skip`	The number of documents to skip before counting. Default: `0`

Tip

Cuando se utiliza CountDocuments() para devolver el número total de documentos en una colección, MongoDB realiza un escaneo de colección. Puedes evitar un escaneo de colección y mejorar el rendimiento de este método utilizando una sugerencia para aprovechar la funcionalidad incorporada en el índice en el campo _id. Usa esta técnica solo cuando llames a CountDocuments() con un parámetro de query vacío.

var filter = Builders<Student>.Filter.Empty;
CountOptions opts = new CountOptions(){Hint = "_id_"};
var count = collection.CountDocuments(filter, opts);

Recuento estimado

Para estimar el número total de documentos en tu colección, utiliza el método EstimatedDocumentCount().

Nota

El método EstimatedDocumentCount() es más eficiente que el método CountDocuments() porque utiliza los metadatos de la colección en lugar de escanear toda la colección.

Modificar comportamiento

Puedes modificar el comportamiento de EstimatedDocumentCount() pasando un tipo EstimatedDocumentCountOptions como parámetro. Si no especifica ninguna opción, el driver utiliza valores por defecto.

Puedes establecer las siguientes propiedades en un objeto EstimatedDocumentCountOptions:

Propiedad	Descripción
`MaxTime`	The maximum amount of time that the query can run on the server. Default: `null`

Ejemplo

El siguiente ejemplo estima la cantidad de documentos en la colección students:

var count = _myColl.EstimatedDocumentCount();
Console.WriteLine("Estimated number of documents in the students collection: " + count);

Estimated number of documents in the students collection: 6

Agregación

Puede utilizar el método de construcción Count() para contar la cantidad de documentos en una secuencia de agregación.

Ejemplo

El siguiente ejemplo realiza las siguientes acciones:

Especifica una etapa de coincidencia para encontrar documentos con un valor FinalGrade mayor que 80
Cuenta el número de documentos que coinciden con los criterios

var filter = Builders<Student>
  .Filter.Gt(s => s.FinalGrade, 80);
var result = _myColl.Aggregate().Match(filter).Count();
Console.WriteLine("Number of documents with a final grade more than 80: " + result.First().Count);

Number of documents with a final grade more than 80: 4

Información Adicional

Para aprender más sobre las operaciones mencionadas, consulte las siguientes guías:

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:

Volver

Especifique los campos a devolver

Recuperar valores distintos de campo