Thursday, October 10, 2019

CRUD Operation In ASP.NET Core MVC Using Visual Studio Code

Introduction
In this article, I am going to explain how to create a basic web application using ASP.NET Core MVC and Visual Studio Code in a Windows system. We are going to create a sample Employee Records Management System.
We will be using ASP.NET Core 2.0, Entity Framework, and SQLite.
Prerequisites
  • Install .NET Core 2.0.0 SDK from here.
  • Download and install Visual Studio Code from here.
  • Familiarize yourself with Visual Studio Code from here.
Now, we are ready to proceed with creation of our first web app. 
Create the MVC Web App
Press Window+R. It will open the "Run" window. Type ‘cmd’ and press ‘OK’. It will open the command prompt in your system.
Type the following commands. It will create our MVC application “MvcDemo”.
  • mkdir MvcDemo
  • cd MvcDemo
  • dotnet new mvc 


Open this “MvcDemo” application using Visual Studio Code. If it prompts the message "Required assets to build and debug are missing from 'MvcDemo'. Add them?", select "Yes".



Add data Model Class
Right click on Models folder and select a "New "file. Give it a name such as Employees.cs. It will create a file inside Models folder.

Open Employees.cs file and paste the following code to create Employee class.
  1. using System;  
  2. using System.ComponentModel.DataAnnotations;  
  3.   
  4. namespace MvcDemo.Models  
  5. {  
  6.     public class Employees  
  7.     {  
  8.         public int Id { getset; }  
  9.         [Required]  
  10.         public string Name { getset; }  
  11.         [Required]  
  12.         public string City { getset; }  
  13.         [Required]  
  14.         public string Department { getset; }  
  15.         [Required]  
  16.         public int Salary {get;set;}  
  17.     }  
  18. }  
Since we are adding the required validators to the fields of Employee class, so we need using System.ComponentModel.DataAnnotations at the top.
Add references for scaffolding
Now, our data model class is created. We will create Views and Controllers using scaffolding. For scaffolding, we need to add NuGet package references in <ItemGroup> tag in MvcDemo.csproj file.
  1. <Project Sdk="Microsoft.NET.Sdk.Web">  
  2.   
  3.   <PropertyGroup>  
  4.     <TargetFramework>netcoreapp2.0</TargetFramework>  
  5.   </PropertyGroup>  
  6.   
  7.   <ItemGroup>  
  8.     <PackageReference Include="Microsoft.AspNetCore.All" Version="2.0.0" />  
  9.     <PackageReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Design" Version="2.0.0" />  
  10.   </ItemGroup>  
  11.   
  12.   <ItemGroup>  
  13.     <DotNetCliToolReference Include="Microsoft.VisualStudio.Web.CodeGeneration.Tools" Version="2.0.0" />  
  14.     <DotNetCliToolReference Include="Microsoft.EntityFrameworkCore.Tools.DotNet" Version="2.0.0" />  
  15.   </ItemGroup>  
  16.   
  17. </Project>  
Save the file and select "Restore" to the Info message "There are unresolved dependencies".
Now, your MvcDemo.csproj will look like this.
The next step is to add MVCEmployeeContext.cs file in our Models folder. Open the file and add the following lines of code.
  1. using Microsoft.EntityFrameworkCore;  
  2.   
  3. namespace MvcDemo.Models  
  4. {  
  5.     public class MvcEmployeeContext : DbContext  
  6.     {  
  7.         public MvcEmployeeContext (DbContextOptions<MvcEmployeeContext> options)  
  8.             : base(options)  
  9.         {  
  10.         }  
  11.   
  12.         public DbSet<MvcDemo.Models.Employees> Employee { getset; }  
  13.     }  
  14. }  
Now, your MVCEmployeeContext.cs file looks like this.
Now, open Startup.cs file and add following two using statements at the top.
  1. using Microsoft.EntityFrameworkCore;  
  2. using MvcDemo.Models  
Add database context to Startup.cs file by adding following line in ConfigureServices method
  1. services.AddDbContext<MvcEmployeeContext>(options =>options.UseSqlite("Data Source=MvcEmployee.db"));  
This line of code tells Entity Framework which model classes are included in the data model. You're defining one entity set of Employee object, which will be represented in the database as an Employee table.
So our Startup.cs willl look like this,
  1. using System;  
  2. using System.Collections.Generic;  
  3. using System.Linq;  
  4. using System.Threading.Tasks;  
  5. using Microsoft.AspNetCore.Builder;  
  6. using Microsoft.AspNetCore.Hosting;  
  7. using Microsoft.Extensions.Configuration;  
  8. using Microsoft.Extensions.DependencyInjection;  
  9. using Microsoft.EntityFrameworkCore;  
  10. using MvcDemo.Models;  
  11.   
  12. namespace MvcDemo  
  13. {  
  14.     public class Startup  
  15.     {  
  16.         public Startup(IConfiguration configuration)  
  17.         {  
  18.             Configuration = configuration;  
  19.         }  
  20.   
  21.         public IConfiguration Configuration { get; }  
  22.         public void ConfigureServices(IServiceCollection services)  
  23.         {  
  24.             services.AddMvc();  
  25.   
  26.             services.AddDbContext<MvcEmployeeContext>(options =>options.UseSqlite("Data Source=MvcEmployee.db"));  
  27.         }  
  28.   
  29.         // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.  
  30.         public void Configure(IApplicationBuilder app, IHostingEnvironment env)  
  31.         {  
  32.             if (env.IsDevelopment())  
  33.             {  
  34.                 app.UseDeveloperExceptionPage();  
  35.             }  
  36.             else  
  37.             {  
  38.                 app.UseExceptionHandler("/Home/Error");  
  39.             }  
  40.   
  41.             app.UseStaticFiles();  
  42.   
  43.             app.UseMvc(routes =>  
  44.             {  
  45.                 routes.MapRoute(  
  46.                     name: "default",  
  47.                     template: "{controller=Home}/{action=Index}/{id?}");  
  48.             });  
  49.         }  
  50.     }  
  51. }  
Scaffold the Employee Controller
Now, we are going to Scaffold the controller and Razor view files. Navigate to MvcDemo project folder in your system.
Press and hold Shift and right click, it will give you the option to “open PowerShell window here “as shown in image below. Click and it will open a PowerShell window.

Here, I am using Windows PowerShell but you can use command prompt also. It will give the same results.
Run the following commands in PowerShell console.
  • dotnet restore
  • dotnet aspnet-codegenerator controller -name EmployeeController -m Employees -dc MvcEmployeeContext --relativeFolderPath Controllers --useDefaultLayout --referenceScriptLibraries

This will create following in our project
  • An Employee controller (Controllers/EmployeeController.cs)
  • Razor view files for Create, Delete, Details, Edit and Index pages (Views/Employee/\.cshtml)

This process of automatically creating CRUD(Create, Read, Update, Delete) action methods and views is known as scaffolding.
Initial Migration of Database
Open PowerShell in Project folder again.
Run the following commands,
  • dotnet ef migrations add InitialCreate
  • dotnet ef database update 
The “dotnet ef migrations add InitialCreate” command generates code to create the initial database schema. The schema is based on the model specified in the DbContext (In the Models/MVCEmployeeContext.cs file).

After running the second command you will get a message at end "Done".
And that’s it. We have created our first ASP.Net Core MVC application.
Before running the application ,open launch.json and make sure that ‘Program’ path is set correctly as
  1. "program""${workspaceRoot}/bin/Debug/netcoreapp2.0/MvcDemo.dll"  
 Now your launch.json will look like this,
  1. {  
  2.    // Use IntelliSense to find out which attributes exist for C# debugging  
  3.    // Use hover for the description of the existing attributes  
  4.    // For further information visit https://github.com/OmniSharp/omnisharp-vscode/blob/master/debugger-launchjson.md  
  5.    "version""0.2.0",  
  6.    "configurations": [  
  7.         {  
  8.             "name"".NET Core Launch (web)",  
  9.             "type""coreclr",  
  10.             "request""launch",  
  11.             "preLaunchTask""build",  
  12.             // If you have changed target frameworks, make sure to update the program path.  
  13.             "program""${workspaceRoot}/bin/Debug/netcoreapp2.0/MvcDemo.dll",  
  14.             "args": [],  
  15.             "cwd""${workspaceRoot}",  
  16.             "stopAtEntry"false,  
  17.             "internalConsoleOptions""openOnSessionStart",  
  18.             "launchBrowser": {  
  19.                 "enabled"true,  
  20.                 "args""${auto-detect-url}",  
  21.                 "windows": {  
  22.                     "command""cmd.exe",  
  23.                     "args""/C start ${auto-detect-url}"  
  24.                 },  
  25.                 "osx": {  
  26.                     "command""open"  
  27.                 },  
  28.                 "linux": {  
  29.                     "command""xdg-open"  
  30.                 }  
  31.             },  
  32.             "env": {  
  33.                 "ASPNETCORE_ENVIRONMENT""Development"  
  34.             },  
  35.             "sourceFileMap": {  
  36.                 "/Views""${workspaceRoot}/Views"  
  37.             }  
  38.         },  
  39.         {  
  40.             "name"".NET Core Attach",  
  41.             "type""coreclr",  
  42.             "request""attach",  
  43.             "processId""${command:pickProcess}"  
  44.         }  
  45.     ]  
  46. }  
Now press F5 to debug the application. It will open the browser, navigate to http://localhost:xxxx/employee
You can see the page shown below.
 
Now we will proceed with our CRUD operations.
Click on CreateNew to create a new Employee record. Add a new Employee record as shown in image below.
If we miss data in any fields while creating employee record, we will get a required field validation message.
After you click on Create button in "Create View", it will redirect to Index View where we can see all the employees added by us. Here, we can also see action methods Edit, Details and Delete.


If we want to edit an existing employee record, then click Edit action link. It will open Edit View as below where we can change the employee data. 


Here we have changed the Salary of employee with name Dhiraj from 200000 to 250000. Click on Save to return to Index view to see the updated changes as highlighted in image below.


If we miss any fields while editing employee records, then edit view will also throw required field validation error message.



If you want to see the details of any Employee, then click on Details action link, which will open the Details view as shown in image below.

Click on Back to List to go back to Index view.Now we will perform Delete operation on Employee with name Dhiraj.Click on Delete action link which will open Delete view asking for a confirmation to delete the employee.
Once we click on Delete button the employee record gets deleted and we will be redirected to Index view. Here we can see that the employee with name Dhiraj has been removed from our record.

An Insight into Delete method
Open EmployeeController.cs and scroll down to Delete method. You can observe that we have two Delete method, one each for HTTP Get and HTTP Post.
  1. // GET: Employee/Delete/5  
  2.        public async Task<IActionResult> Delete(int? id)  
  3.        {  
  4.            if (id == null)  
  5.            {  
  6.                return NotFound();  
  7.            }  
  8.   
  9.            var employees = await _context.Employee  
  10.                .SingleOrDefaultAsync(m => m.Id == id);  
  11.            if (employees == null)  
  12.            {  
  13.                return NotFound();  
  14.            }  
  15.   
  16.            return View(employees);  
  17.        }  
  18.   
  19.        // POST: Employee/Delete/5  
  20.        [HttpPost, ActionName("Delete")]  
  21.        [ValidateAntiForgeryToken]  
  22.        public async Task<IActionResult> DeleteConfirmed(int id)  
  23.        {  
  24.            var employees = await _context.Employee.SingleOrDefaultAsync(m => m.Id == id);  
  25.            _context.Employee.Remove(employees);  
  26.            await _context.SaveChangesAsync();  
  27.            return RedirectToAction(nameof(Index));  
  28.        }  
Note that the HTTP GET Delete method doesn't delete the specified employee record, it returns a view of the employee where you can submit (HttpPost) the deletion. Performing a delete operation in response to a GET request (or for that matter, performing an edit operation, create operation, or any other operation that changes data) opens up a security hole.
The [HttpPost] method that deletes the data is named DeleteConfirmed to give the HTTP POST method a unique signature 
Conclusion
We have learned about creating a sample web application using ASP.Net Core MVC and perform CRUD operations on it. We have used Entity Framework and SQLite for our Demo. Please refer to attached code for better understanding.

No comments:

Post a Comment

How to register multiple implementations of the same interface in Asp.Net Core?

 Problem: I have services that are derived from the same interface. public interface IService { } public class ServiceA : IService { ...