/ /

Exclua documentos

Visão geral

Neste guia, você pode aprender como remover documentos de suas coleções MongoDB usando operações de exclusão.

Dados de amostra

Os exemplos neste guia utilizam a coleção do restaurants a partir do banco de dados do sample_restaurants. Os documentos nesta coleção usam as seguintes classes Restaurant, Address e 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; }
}

Observação

Os documentos na collection restaurants usam a convenção de nomenclatura snake-case. Os exemplos neste guia usam um ConventionPack para desserializar os campos na coleção em maiúsculas e minúsculas Pascal e mapeá-los para as propriedades na classe Restaurant .

Para saber mais sobre serialização personalizada, consulte Serialização personalizada.

Essa collection é dos conjuntos de dados de amostra fornecidos pelo Atlas. Consulte a Introdução ao driver .NET/C# para saber como criar um cluster MongoDB gratuito e carregar esses dados de exemplo.

Excluir operações

Use operações de exclusão para remover documentos que correspondam a um filtro de consulta. O filtro de consulta determina quais registros são selecionados para exclusão com base nos critérios do documento de filtro de consulta. Você pode executar operações de exclusão no MongoDB com os seguintes métodos:

DeleteOne(), que exclui o primeiro documento que corresponde ao filtro de query
DeleteMany(), que exclui todos os documentos que correspondem ao filtro de query

Excluir um documento

O código abaixo mostra como usar o método síncrono DeleteOne() ou o método assíncrono DeleteOneAsync() para excluir um documento.

var result = _restaurantsCollection.DeleteOne(filter);

var result = await _restaurantsCollection.DeleteOneAsync(filter);

Excluir vários documentos

O código abaixo mostra como usar o método síncrono DeleteMany() ou o método assíncrono DeleteManyAsync() para excluir todos os documentos correspondentes.

var result = _restaurantsCollection.DeleteMany(filter);

var result = await _restaurantsCollection.DeleteManyAsync(filter);

Dica

Encontre exemplos executáveis usando esses métodos em informações adicionais.

Parâmetros

Os métodos DeleteOne() e DeleteMany() exigem que você passe um filtro de query especificando quais documentos devem corresponder. Mais informações sobre como construir um filtro de query estão disponíveis no tutorial Documentos de query.

Ambos os métodos recebem opcionalmente um tipo DeleteOptions como parâmetro adicional, que representa opções que você pode usar para configurar a operação de exclusão. Se você não especificar nenhuma propriedade DeleteOptions , o driver não personalizará a operação de exclusão.

O tipo DeleteOptions permite a você configurar opções com as seguintes propriedades:

Propriedade	Descrição
`Collation`	Obtém ou define o tipo de agrupamento de idiomas a ser usado ao classificar os resultados. Consulte a seção Agrupamento desta página para obter mais informações.
`Comment`	Obtém ou define o comentário para a operação. Consulte os campos do comando delete para obter mais informações.
`Hint`	Obtém ou define o índice a ser usado para procurar documentos. Consulte as instruções de exclusão para obter mais informações.
`Let`	Obtém ou define o documento de permissão. Consulte os campos do comando delete para obter mais informações.

Agrupamentos

Para configurar o agrupamento para sua operação, crie uma instância da classe Agrupamento.

A tabela seguinte descreve os parâmetros que o construtor do Collation aceita. Ela também lista a propriedade de classe correspondente que você pode usar para ler o valor de cada configuração.

Parâmetro	Descrição	Propriedade de classe
`locale`	Especifica a locale Componentes internacionais para Unicode (ICU). Para obter uma lista de localidades suportadas, consulte Localidades de Agrupamento e Parâmetros Padrão no Manual do MongoDB Server . Se você quiser usar a comparação binária simples, use a `Collation.Simple` propriedade estática para retornar um `Collation` objeto com o `locale` definido `"simple"` como. Tipo de dados: `string`	`Locale`
`caseLevel`	(Opcional) Especifica se incluir comparação de caso. Quando esse argumento `true` é, o comportamento do driver depende do valor do `strength` argumento: - Se `strength` `CollationStrength.Primary`for, o driver compara caracteres básicos e maiúsculas e minúsculas. - `strength` Se `CollationStrength.Secondary` for, o driver compara caracteres básicos, diacríticos, outras diferenças secundárias e maiúsculas e minúsculas. - Se `strength` for qualquer outro valor, esse argumento será ignorado. Quando esse argumento `false` é, o driver não inclui comparação de caso no nível de força `Primary` `Secondary`ou. Tipo de Dados: `boolean` Padrão: `false`	`CaseLevel`
`caseFirst`	(Opcional) Especifica a ordem de classificação das diferenças de caso durante as comparações de nível terciário. Tipo de dados: CollationCaseFirst padrão: `CollationCaseFirst.Off`	`CaseFirst`
`strength`	(Opcional) Especifica o nível de comparação a ser executado, conforme definido na documentação da ICU. Tipo de Dados: CollationStrength Padrão: `CollationStrength.Tertiary`	`Strength`
`numericOrdering`	(Opcional) Especifica se o driver compara strings numéricas como números. Se esse argumento `true` for, o driver compara strings numéricas como números. Por exemplo, ao comparar as strings "10" e "2", o driver trata os valores como 10 e 2 e considera 10 maior. Se esse argumento for `false` ou excluído, o driver compara cadeias de caracteres numéricas como cadeias de caracteres. Por exemplo, ao comparar as strings "10" e "2", o driver compara um caractere de cada vez. Como "1" é menor que "2", o driver acha que "10" é menor que "2". Para obter mais informações, consulte Restrições de agrupamento no manual do MongoDB Server . Tipo de dados: `boolean` Padrão: `false`	`NumericOrdering`
`alternate`	(Opcional) Especifica se o driver considera o espaço em branco e a pontuação como caracteres básicos para fins de comparação. Tipo de dados: CollationAlterne padrão: `CollationAlternate.NonIgnorable` (espaços e pontuação são considerados caracteres básicos)	`Alternate`
`maxVariable`	(Opcional) Especifica quais caracteres o driver considera ignoráveis quando o `alternate` argumento `CollationAlternate.Shifted` é. Tipo de Dados: CollationMaxVariable Padrão: `CollationMaxVariable.Punctuation` (o driver ignora pontuação e espaços)	`MaxVariable`
`normalization`	(Opcional) Especifica se o driver normaliza o texto conforme necessário. A maioria dos textos não exige normalização. Para obter mais informações sobre normalização, consulte a documentação da ICU. Tipo de dados: `boolean` Padrão: `false`	`Normalization`
`backwards`	(Opcional) Especifica se as strings contendo diacríticos são classificadas da parte de trás da string para a frente. Tipo de dados: `boolean` Padrão: `false`	`Backwards`

Para obter mais informações sobre agrupamento, consulte a página Agrupamento no manual do MongoDB Server.

Exemplo

O código a seguir utiliza o método DeleteMany() para pesquisar no índice " borough_1" e excluir todos os documentos em que o valor do campo address.street contenha a 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

Dica

Se o exemplo anterior usasse o método DeleteOne() em vez de DeleteMany(), o driver excluiria o primeiro dos 26 documentos correspondentes.

Valor de retorno

Os métodos DeleteOne() e DeleteMany() retornam um tipo DeleteResult . Este tipo contém a propriedade DeletedCount , que indica o número de documentos excluídos, e a propriedade IsAcknowledged , que indica se o resultado é reconhecido. Se o filtro de query não corresponder a nenhum documento, nenhum documento será excluído e DeletedCount será 0.

Informações adicionais

Para obter exemplos executáveis das operações de exclusão, consulte os seguintes exemplos de uso:

Documentação da API

Para saber mais sobre qualquer um dos métodos ou tipos discutidos neste guia, consulte a seguinte documentação da API:

Voltar

Substituir documentos

Operações de gravação em massa