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 inserta uno o más documentos en una colección de MongoDB. El controlador .NET/C# ofrece los siguientes métodos para llevar a cabo operaciones de inserción, cada uno de los cuales tiene una versión sincrónica y asincrónica:

• InsertOne() or ``InsertOneAsync()

• InsertMany() or InsertManyAsync()

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 usar el método síncrono InsertOne() o el método asíncrono InsertOneAsync() para insertar un documento.

_restaurantsCollection.InsertOne(document);

await _restaurantsCollection.InsertOneAsync(document);

Inserta varios documentos

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

_restaurantsCollection.InsertMany(docs);

await _restaurantsCollection.InsertManyAsync(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 intenta insertar estos documentos con el InsertManyOptions por defecto, el controlador lanza un MongoBulkWriteException en el tercer documento debido al valor _id repetido. La operación añade solo los dos primeros documentos a la colección:

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

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

{ "_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:

• InsertOne()

• InsertOneAsync()

• InsertMany()

• InsertManyAsync()