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 Introducción al controlador .NET/C# 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 sincrónico DeleteOne() o el método asincrónico DeleteOneAsync() para eliminar un documento.

var result = _restaurantsCollection.DeleteOne(filter);

var result = await _restaurantsCollection.DeleteOneAsync(filter);

Borra varios documentos

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

var result = _restaurantsCollection.DeleteMany(filter);

var result = await _restaurantsCollection.DeleteManyAsync(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:

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

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