Insira documentos

Abrir tutorial interativo

Visão geral

Neste guia, você pode aprender como usar o Driver MongoDB .NET/C# para adicionar documentos a uma coleção MongoDB realizando operações de inserção.

Uma operação de inserção insere um ou mais documentos em uma coleção MongoDB. O driver .NET/C# fornece os seguintes métodos para executar operações de inserção, cada um dos quais tem uma versão assíncrona e síncrona:

• InsertOneAsync() ou InsertOne()

• InsertManyAsync() ou InsertMany()

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; }
}

O campo _id

Em uma coleção MongoDB, cada documento deve conter um campo _id com um valor de campo único.

O MongoDB permite gerenciar este campo de duas maneiras:

• Você mesmo pode definir este campo para cada documento, garantindo que cada valor do campo _id seja único.

• Você pode permitir que o acionador gere automaticamente valores de ObjectId únicos para cada documento _id. Se você não definir manualmente um valor de campo _id para um documento, o driver preencherá o campo com uma ObjectId.

A menos que você possa garantir exclusividade, o MongoDB recomenda que você deixe o driver gerar automaticamente os valores do _id.

Para saber mais sobre o campo _id, consulte a Entrada manual do servidor sobre Índices únicos.

Para saber mais sobre a estrutura e as regras dos documentos, consulte a Entrada do Manual do Servidor sobre Documentos.

Inserir um documento

O código abaixo mostra como usar o método InsertOneAsync() assíncrono ou o método InsertOne() síncrono para inserir um documento.

await _restaurantsCollection.InsertOneAsync(document);

_restaurantsCollection.InsertOne(document);

Insira vários documentos

O seguinte código mostra como utilizar o método InsertManyAsync() assíncrono ou o método InsertMany() síncrono para inserir vários documentos.

await _restaurantsCollection.InsertManyAsync(docs);

_restaurantsCollection.InsertMany(docs);

Modificar comportamento de inserção

O método InsertOne() usa o documento que você deseja inserir como parâmetro. O método InsertMany() usa uma coleção IEnumerable de documentos, como uma lista ou array, como parâmetro.

O método InsertOne() recebe opcionalmente um tipo InsertOneOptions como parâmetro adicional, que representa as opções que você pode usar para configurar a operação de inserção. Se você não especificar nenhuma propriedade InsertOneOptions, o driver não personalizará a inserção.

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

O método InsertMany() opcionalmente usa um tipo InsertManyOptions como um parâmetro adicional, que tem as propriedades BypassDocumentValidation e Comment anteriores e a propriedade IsOrdered adicional:

// Generates 5 new restaurants by using a helper method
var restaurants = GenerateDocuments();
// Creates an option object to bypass documentation validation on the documents
var options = new InsertManyOptions() { BypassDocumentValidation = true };
// Inserts the new documents into the restaurants collection with the specified options
_restaurantsCollection.InsertMany(restaurants, options);

Especificar comportamento ordenado

Suponha que você queira inserir os seguintes documentos:

{ "_id" : 1, "name" : "Restaurant A" }
{ "_id" : 2, "name" : "Restaurant B" }
{ "_id" : 1, "name" : "Restaurant C" }
{ "_id" : 3, "name" : "Restaurant D" }

Se você tentar inserir esses documentos com InsertManyOptions padrão, o driver lançará uma MongoBulkWriteException no terceiro documento devido ao valor de _id repetido, mas os documentos antes do documento de produção de erro ainda serão inseridos em sua coleção.

Se você examinar sua coleção, poderá ver os seguintes documentos:

{ "_id" : 1, "name" : "Restaurant A" }
{ "_id" : 2, "name" : "Restaurant B" }

Se você definir IsOrdered como false na operação de inserção, o driver continuará inserindo seus documentos mesmo que alguns documentos produzam erros. Com esse comportamento de inserção modificado, o driver lança uma exceção, mas insere todos os documentos que não produzem erros.

Se você examinar sua coleção, poderá ver os seguintes documentos:

{ "_id" : 1, "name" : "Restaurant A" }
{ "_id" : 2, "name" : "Restaurant B" }
{ "_id" : 3, "name" : "Restaurant D" }

Informações adicionais

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

• Insira um documento

• Insira vários documentos