Excluir um documento
Nesta página
Você pode excluir um documento de uma coleção usado o método DeleteOne()
síncrono ou o método DeleteOneAsync()
assíncrono.
Observação
O método DeleteOne()
exclui somente o primeiro documento que corresponde ao filtro. Para excluir mais de um documento, use o método DeleteMany()
.
Para saber mais sobre como usar DeleteMany()
, consulte Excluir muitos documentos.
Exemplo
Exclua um documento usando construtores
O exemplo abaixo usa Builders
para excluir um documento na coleção restaurants
com a name
"Ready Penny Inn".
Selecione a aba Asynchronous ou Synchronous para ver o código correspondente.
// Creates a filter for all documents that have a "name" value of "Ready Penny Inn" var filter = Builders<Restaurant>.Filter .Eq(r => r.Name, "Ready Penny Inn"); // Asynchronously deletes the first document that matches the filter return await _restaurantsCollection.DeleteOneAsync(filter);
Para obter um exemplo totalmente executável do DeleteOne()
método, consulte o exemplo de exclusão assíncrona.
// Creates a filter for all documents that have a "name" value of "Ready Penny Inn" var filter = Builders<Restaurant>.Filter .Eq(r => r.Name, "Ready Penny Inn"); // Deletes the first document that matches the filter return _restaurantsCollection.DeleteOne(filter);
Para obter um exemplo totalmente executável do DeleteOne()
método , consulte o Exemplo síncrono de excluir um
Resultado esperado
A execução de qualquer um dos exemplos completos anteriores imprime os seguintes resultados:
Deleting a document with builders... Deleted documents: 1
Informações adicionais
Para saber mais sobre como excluir documentos, consulte o guia Exclua documentos.
Para saber mais sobre como usar construtores, consulte Operações com construtores.