--- title: "Implement MongoDB in .NET Core: Step-by-Step Guide" description: "Learn how to implement MongoDB in .NET Core with this complete step-by-step guide. Build an ASP.NET Core Web API with MongoDB and perform CRUD operations effici" author: "Anubhav Sharma" published: 2026-06-29 updated: 2026-06-29 canonical: https://answers.mindstick.com/blog/453/implement-mongodb-in-dot-net-core-step-by-step-guide category: "database" tags: ["database", "mongoose"] reading_time: 4 minutes --- # Implement MongoDB in .NET Core: Step-by-Step Guide Modern applications require flexible and scalable databases to handle large amounts of structured and unstructured data. While SQL databases are excellent for relational data, [NoSQL databases](https://www.mindstick.com/blog/304190/10-best-nosql-databases) like MongoDB provide greater flexibility and horizontal scalability. ![Implement MongoDB in .NET Core: Step-by-Step Guide](https://answers.mindstick.com/blogs/eabb6927-8c7b-4aae-8d65-fedfb3bd745c/images/701e0f25-e1c8-4a44-b31c-e3f793c3d65d.png) ## What is MongoDB? MongoDB is an open-source, document-oriented NoSQL database that stores data in **JSON-like documents called BSON (Binary JSON)**. Unlike traditional relational databases, MongoDB doesn't require a fixed schema, making it ideal for applications with rapidly changing requirements. ### Benefits of MongoDB - Schema-less database design - High scalability and performance - Easy integration with cloud applications - Flexible document model - Supports large volumes of data ## Prerequisites Before starting, make sure you have the following installed: - .NET 8 SDK or .NET 7 SDK - MongoDB Community Server - Visual Studio 2022 or Visual Studio Code - Basic knowledge of ASP.NET Core Web API ## Step 1: Create a New ASP.NET Core Web API Project Open the terminal and execute: ```plaintext dotnet new webapi -n MongoDbDemo cd MongoDbDemo ``` Run the application: ```plaintext dotnet run ``` ## Step 2: Install MongoDB Driver Install the official MongoDB package using NuGet: ```plaintext dotnet add package MongoDB.Driver ``` Or use the Package Manager Console: ```plaintext Install-Package MongoDB.Driver ``` ## Step 3: Configure MongoDB Settings Create a folder named **Configurations** and add a class named `MongoDbSettings.cs`. ```cs public class MongoDbSettings { public string ConnectionString { get; set; } = null!; public string DatabaseName { get; set; } = null!; public string CollectionName { get; set; } = null!; } ``` ## Step 4: Add Configuration in appsettings.json ```plaintext { "MongoDbSettings": { "ConnectionString": "mongodb://localhost:27017", "DatabaseName": "EmployeeDb", "CollectionName": "Employees" } } ``` ## Step 5: Create the Model Create a Models folder and add `Employee.cs`. ```cs using MongoDB.Bson; using MongoDB.Bson.Serialization.Attributes; public class Employee { [BsonId] [BsonRepresentation(BsonType.ObjectId)] public string? Id { get; set; } public string Name { get; set; } = string.Empty; public string Department { get; set; } = string.Empty; public decimal Salary { get; set; } } ``` ## Step 6: Create MongoDB Service Create a Services folder and add `EmployeeService.cs`. ```cs using MongoDB.Driver; public class EmployeeService { private readonly IMongoCollection _employees; public EmployeeService(IOptions settings) { var mongoClient = new MongoClient( settings.Value.ConnectionString); var mongoDatabase = mongoClient.GetDatabase( settings.Value.DatabaseName); _employees = mongoDatabase.GetCollection( settings.Value.CollectionName); } public async Task> GetAsync() => await _employees.Find(_ => true).ToListAsync(); public async Task GetAsync(string id) => await _employees.Find(x => x.Id == id) .FirstOrDefaultAsync(); public async Task CreateAsync(Employee employee) => await _employees.InsertOneAsync(employee); public async Task UpdateAsync(string id, Employee employee) => await _employees.ReplaceOneAsync(x => x.Id == id, employee); public async Task DeleteAsync(string id) => await _employees.DeleteOneAsync(x => x.Id == id); } ``` ## Step 7: Register Services in Program.cs ```cs builder.Services.Configure( builder.Configuration.GetSection("MongoDbSettings")); builder.Services.AddSingleton(); ``` ## Step 8: Create API Controller Create `EmployeesController.cs`. ```cs [ApiController] [Route("api/[controller]")] public class EmployeesController : ControllerBase { private readonly EmployeeService _employeeService; public EmployeesController(EmployeeService employeeService) { _employeeService = employeeService; } [HttpGet] public async Task> Get() => await _employeeService.GetAsync(); [HttpGet("{id}")] public async Task> Get(string id) { var employee = await _employeeService.GetAsync(id); if (employee is null) return NotFound(); return employee; } [HttpPost] public async Task Post(Employee employee) { await _employeeService.CreateAsync(employee); return CreatedAtAction(nameof(Get), new { id = employee.Id }, employee); } [HttpPut("{id}")] public async Task Update( string id, Employee employee) { await _employeeService.UpdateAsync(id, employee); return NoContent(); } [HttpDelete("{id}")] public async Task Delete(string id) { await _employeeService.DeleteAsync(id); return NoContent(); } } ``` ## Step 9: Run the Application Execute: ```plaintext dotnet run ``` Open Swagger: ```plaintext https://localhost:5001/swagger ``` You can now perform: - GET all employees - GET employee by ID - POST new employee - PUT update employee - DELETE employee ## Testing the API ### Create Employee ```plaintext { "name": "John Doe", "department": "IT", "salary": 50000 } ``` ### Response ```plaintext { "id": "6656d7a31c74f19f1d55d001", "name": "John Doe", "department": "IT", "salary": 50000 } ``` ## Advantages of Using MongoDB with .NET Core - High performance for large datasets. - Flexible schema design. - Easy integration using MongoDB.Driver. - Excellent support for microservices architecture. - Suitable for cloud-native applications. ## Best Practices - Use Dependency Injection. - Store connection strings in configuration files. - Implement Repository Pattern for large applications. - Add proper exception handling. - Use indexes for better query performance. - Implement pagination for large collections. - Secure MongoDB with authentication. ## Conclusion MongoDB and .NET Core make an excellent combination for building scalable, high-performance applications. By following the steps in this tutorial, you can easily integrate MongoDB into your ASP.NET Core Web API and implement complete CRUD operations. As your application grows, you can further enhance it by implementing Repository Pattern, Generic Services, Authentication, and advanced MongoDB features such as Aggregation Pipelines and Transactions. --- Original Source: https://answers.mindstick.com/blog/453/implement-mongodb-in-dot-net-core-step-by-step-guide Copyright © MindStick Software Pvt. Ltd. This Markdown version is provided for developers, AI systems, and offline reading.