insertMany.txt

.. _csharp-insert-many:

=========================
Insert Multiple Documents
=========================

.. facet::
   :name: genre
   :values: reference

.. meta::
   :keywords: code example, .NET, operation
   :description: Learn to insert multiple documents into a collection using C# with synchronous and asynchronous methods.

.. contents:: On this page
   :local:
   :backlinks: none
   :depth: 2
   :class: singlecol

You can insert multiple documents into a collection by using the synchronous
``InsertMany()`` method or the asynchronous ``InsertManyAsync()`` method.

Example
-------

The following example inserts multiple documents into 
the ``restaurants`` collection.

Select the :guilabel:`Synchronous` or :guilabel:`Asynchronous` tab to see the 
corresponding code.

.. tabs::

   .. tab:: Synchronous
      :tabid: insert-many-sync

      .. literalinclude:: ../includes/code-examples/insert-many/InsertMany.cs
         :start-after: start-insert-many
         :end-before: end-insert-many
         :language:  csharp
         :copyable:
         :dedent:

      For a fully runnable example of the ``InsertMany()`` operation, see the
      `InsertMany code sample <{+example+}/insert-many/InsertMany.cs>`__.

   .. tab:: Asynchronous
      :tabid: insert-many-async

      .. literalinclude:: ../includes/code-examples/insert-many/InsertManyAsync.cs
         :start-after: start-insert-many
         :end-before: end-insert-many
         :language:  csharp
         :copyable:
         :dedent:

      For a fully runnable example of the ``InsertManyAsync()`` operation, see the
      `InsertManyAsync code sample <{+example+}/insert-many/InsertManyAsync.cs>`__.

Expected Result
~~~~~~~~~~~~~~~

After running either of the preceding full examples, the output is as follows:

.. code-block:: none
    
   Number of restaurants found before insert: 0

   Inserting documents...
   Number of restaurants inserted: 5


Additional Information
----------------------

To learn more about using builders, see :ref:`csharp-builders`.

API Documentation
-----------------

- `InsertMany() <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.IMongoCollection-1.InsertMany.html>`__
- `InsertManyAsync() <{+new-api-root+}/MongoDB.Driver/MongoDB.Driver.IMongoCollection-1.InsertManyAsync.html>`__