Delete Documents

Datos de muestra

Los ejemplos de esta guía utilizan el restaurants Colección de la base de datos sample_restaurants. Los documentos de esta colección 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; }
}

Esta colección es de la Conjuntos de datos de muestra proporcionados por Atlas. Consulte la Guía de inicio rápido para aprender a crear un clúster gratuito de MongoDB y cargar estos datos de muestra.

Borrar un documento

El siguiente código muestra cómo utilizar el método asincrónico DeleteOneAsync() o el método sincrónico DeleteOne() para eliminar un documento.

var result = await _restaurantsCollection.DeleteOneAsync(filter);

var result = _restaurantsCollection.DeleteOne(filter);

Borra varios documentos

El siguiente código muestra cómo utilizar el método asincrónico DeleteManyAsync() o el método sincrónico DeleteMany() para eliminar todos los documentos coincidentes.

var result = await _restaurantsCollection.DeleteManyAsync(filter);

var result = _restaurantsCollection.DeleteMany(filter);

Parámetros

Los DeleteOne() DeleteMany() métodos y requieren un filtro de consulta que especifique los documentos que se deben buscar. Encontrará más información sobre cómo construir un filtro de consulta en el tutorial "Consultar documentos".

Ambos métodos aceptan opcionalmente un tipo DeleteOptions como parámetro adicional, que representa las opciones que se pueden usar para configurar la operación de eliminación. Si no se especifica ninguna propiedad DeleteOptions, el controlador no personaliza la operación de eliminación.

El tipo DeleteOptions le permite configurar opciones con las siguientes propiedades:

Ejemplo

El siguiente código utiliza el método DeleteMany() para buscar en el índice "borough_1" y eliminar todos los documentos donde el valor del campo address.street incluye la frase "Pearl Street":

var filter = Builders<Restaurant>.Filter
    .Regex("address.street", "Pearl Street");
DeleteOptions opts = new DeleteOptions { Hint = "borough_1" };
Console.WriteLine("Deleting documents...");
var result = _restaurantsCollection.DeleteMany(filter, opts);
Console.WriteLine($"Deleted documents: {result.DeletedCount}");
Console.WriteLine($"Result acknowledged? {result.IsAcknowledged}");

Deleting documents...
Deleted documents: 26
Result acknowledged? True

Valor de retorno

Los métodos DeleteOne() y DeleteMany() devuelven un tipo DeleteResult. Este tipo contiene la propiedad DeletedCount, que indica el número de documentos eliminados, y la propiedad IsAcknowledged, que indica si se reconoce el resultado. Si el filtro de consulta no coincide con ningún documento, no se elimina ningún documento y DeletedCount es 0.

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:

• deleteOne()

• Eliminar uno asíncrono()

• Eliminar muchos()

• DeleteManyAsync()

• DeleteOptions

• Eliminar resultado