Insertar documentos

Overview

En esta guía, puedes aprender a usar el controlador de MongoDB .NET/C# para agregar documentos a una colección de MongoDB mediante la realización de operaciones de inserción.

Una operación de inserción agrega uno o más documentos a una colección de MongoDB. El Driver .NET/C# proporciona los siguientes métodos para realizar operaciones de inserción, cada uno de los cuales tiene una versión asincrónica y sincrónica:

• InsertOneAsync() or InsertOne()

• InsertManyAsync() or 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; }
}

El campo _id

En una colección de MongoDB, cada documento debe contener un campo _id con un valor de campo único.

MongoDB permite gestionar este campo de dos formas:

• Uno mismo puede configurar este campo para cada documento, asegurando que el valor de cada campo _id sea único.

• Puede permitir que el controlador genere automáticamente valores únicos de ObjectId para cada documento _id. Si no configura manualmente un valor de campo _id para un documento, el controlador rellenará el campo con un ObjectId.

A menos que puedas garantizar la unicidad, MongoDB recomienda que dejes que el controlador genere automáticamente valores de _id.

Para obtener más información sobre el campo _id, consulta la entrada del Manual del Servidor sobre Índices Únicos.

Para aprender más sobre la estructura y las reglas de los documentos, consultar la entrada del Manual del Servidor sobre Documentos.

Inserta un documento

El siguiente código muestra cómo utilizar el método asincrónico InsertOneAsync() o el método sincrónico InsertOne() para insertar un documento.

await _restaurantsCollection.InsertOneAsync(document);

_restaurantsCollection.InsertOne(document);

Inserta varios documentos

El siguiente código muestra cómo utilizar el método asíncrono InsertManyAsync() o el método síncrono InsertMany() para insertar varios documentos.

await _restaurantsCollection.InsertManyAsync(docs);

_restaurantsCollection.InsertMany(docs);

Modificar el comportamiento de inserción

El método InsertOne() toma el documento que desea insertar como parámetro. El método InsertMany() acepta una colección IEnumerable de documentos, como una lista o un arreglo, como parámetro.

El método InsertOne() opcionalmente acepta un tipo InsertOneOptions como parámetro adicional, que representa opciones que se pueden utilizar para configurar la operación de inserción. Si no especifica ninguna propiedad de InsertOneOptions, el driver no personaliza la inserción.

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

El método InsertMany() opcionalmente acepta un tipo InsertManyOptions como parámetro adicional, que tiene las propiedades BypassDocumentValidation y Comment anteriores y la propiedad adicional IsOrdered:

// 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 el comportamiento ordenado

Suponga que desea insertar los siguientes documentos:

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

Si se intenta insertar estos documentos con InsertManyOptions por defecto, el driver lanza una MongoBulkWriteException en el tercer documento debido al valor _id repetido, pero los documentos anteriores al que produce el error siguen insertándose en la colección.

Si miras dentro de tu colección, deberías poder ver los siguientes documentos:

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

Si se configura IsOrdered en false en su operación de inserción, el driver continuará insertando sus documentos, incluso si algunos de ellos producen errores. Con este comportamiento de inserción modificado, el driver lanza una excepción pero inserta todos los documentos que no producen errores.

Si miras dentro de tu colección, deberías poder ver los siguientes documentos:

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

Información Adicional

Para ejemplos ejecutables de las operaciones de inserción, consulte los siguientes ejemplos de uso:

• Insertar un documento
• Inserta varios documentos