In this article, we’ll implement Asp.Net Core 5.0 Web API CRUD Operations with Angular 11. To demonstrate the topic, we’ll build a project from scratch with payment details like credit/ debit card.
GitHub repository: https://bit.ly/3qyiusO
Sub-topics discussed.
- ASP.NET Core Web API
- Create .NET Core Web API
- Setup Database with EF Core
- API Controller for CRUD Web Methods
- Enable CORS for Angular App
- Angular Client Side
- Create Angular 11 Project
- Consume ASP.NET Core API From Angular
- Form Design and Validation
- Insert/ Create Record by Form Submission
- Retrieve and Display Inserted Records
- Update and Delete Operation
Create ASP.NET Core Web API
In Visual Studio 2019, From the new project window, select Asp.Net Core Web Application.
Once you provide the project name and location. A new window will be opened as follows, Select API. The above steps will create a brand new ASP.NET Core Web API project.
Setup Database
Let’s create a Database for this project. Inside this project, we’ll be using Entity Framework Core to create and interact with the database. So first of all we’ve to install corresponding NuGet packages. Right-click on the project name from Solution Explorer, click on Manage NuGet Packages, from Browse Tab, install the following 3 packages with same version as that of Asp.Net Core.
Now, let’s define DB model class file –PaymentDetail.cs
in a new folder Models
.
Now let’s define DbContext
class file- /Models/PaymentDetailContext.cs
.
DbContext class- PaymentDetailContext
decides what should be added to actual physical database during DB Migration. So we have added DbSet
property for PaymentDetail
Model class, after migration PaymentDetails
table will be created in SQL Server Database.
Into this model class constructor parameter- options
, we have to pass which DbProvider (SQL Server, MySQL, PostgreSQL, etc) to use and corresponding DB connection string also. For that, we’ll be using dependency injection in ASP.NET Core with Startup.cs
file as follows.
Here we’ve used dependency injection for DbContext
class, through which SQL Server is set as a DbProvider with a connection string, Now save the connection string in appsettings.json
file using DevConnection
key as follows.
Now let’s do the migration. Select project from solution explorer, then go to Tools > NuGet Package Manager > Package Manager Console. Then execute following commands one by one.
Add-Migration "InitialCreate"
Update-Database
After successful migration, as per the connection string, a new database – PaymentDetailDB
will be created with PaymentDetails
table. Also, there will be a new Migrations
folder created with corresponding C# files.
Create API Controller for CRUD Operations
To create a new API controller, right-click on Controllers folder Add > Controller, Select API Controller with actions, using Entity Framework
.
With the help of scaffolding mechanism, newly created PaymentDetailController
will look like this.
It contains web methods POST, GET, PUT and DELETE for Create, Retrieve, Update and Delete operations respectively. As a constructor parameter we’ve context
of the type PaymentDetailContext
. the instance/value for this parameter will be passed from dependency injection from StartUp
class.
For this project, we don’t have to change anything in web methods and you can test any of these CRUD operations using software like postman or you use open api support with the swagger interface.
Create Angular App
Now let’s create front-end client-side app in Angular 11. For that execute following Angular-CLI commands one by one.
ng new app_name
# after project creation.
# navigate inside project folder
cd app_name
# open in vs code
code .
# from vs code terminal
# command to open the app in default web browser
ng serve --o
Before moving forward, let’s look at the structure of the app that we want to build.
● src
+---● app
| +--● payment-details
| | |--payment-details.component.ts|.html
| | |
| | +--● payment-detail-form
| | |--payment-detail-form.component.ts|.html
| |
| +--● shared
| | |--payment-detail.service.ts
| | |--payment-detail.model.ts
| |
| |--app.module.ts
|
|--index.html (cdn path for bootstrap & fa icons)
We’ve two components, list of records will be shown in payment-details
component, it has a child component payment-detail-form
, inside that, a form for insert and update operation can be designed.
To create these 2 components, you can execute the following commands.
ng g c payment-details -s --skipTests
ng g c payment-details/payment-detail-form -s --skipTests
Options usedinlinestyle | -s
: skip seperate component specific stylesheet---skipTests
: skip test files with extension .spec.ts
Now let’s replace the default component file- app.component.html
as follows.
To show list of records and it’s form side by side, update payment-details.component.html
as bellow.
For this app development, we’ll be using Bootstrap and Font Awesome Icons. so let’s add their stylesheet reference in index.html.
I’ve few custom CSS to add in global style sheet – styles.css
.
.form-group label {
color: grey;
}
.form-group input {
font-weight: 500;
}
.form-group input::placeholder {
color: #c0bdbd;
font-weight: 300;
}
thead th{
font-weight: 400;
}
table tr:hover {
background-color: #fffbf2;
cursor: pointer;
}
/*for invalid form controls*/
input.invalid {
border-color: red;
}
How to Consume .Net Core API from Angular
First of all, let’s create a model class for payment details – shared/payment-detail.model.ts
. You could manually create the file with the following CLI command.
ng g class shared/payment-detail --type=model --skipTests
# there is no seperat command for model
# hence we use class creation command with type option
# type is used to name the file like '.model.ts'
Update the model class with corresponding properties similar to .Net Core API model properties.
Now let’s create a service class to interact with ASP.NET Core Web API- shared/payment-detail.service.ts
. Here is the CLI command to create the service class.
ng g s shared/payment-detail --skipTests
Update the service class as below.
formData
property can be used for designing the form for CRUD Operations, list
array is used to store all of the records from the API. baseURL
contains the base URL for the Web API controller. Now let’s run the API from Visual Studio – Debug > Start Debugging(F5). HttpClient
is used to make HTTP request to the server. Along with methods for CRUD operations, we’ve refreshList
function to populate existing records into list
property.
To use HttpClient
, we also need to import HttpClientModule
. So update app/app.module.ts
as follows.
Form Design and Validation
Now let’s design the form in payment-detail-form
component.
Since we’ve the service injected here. we can access it’s property formData
in component HTML file for designing the form. resetForm
function will reset the form to its initiale state.
As a first step towards designing the form, we’ve to import FormsModule
in app/app.module.ts
.
Now let’s design the form. so update payment-detail-form.component.html
as shown below.
The above code snippet might be confusing for you because here we’ve put everything related to the form design and form validation. we have input fields for all model properties including paymentDetailId
(hidden field). Each of the input field is bound to its respective property through 2 way data-binding.
Inside this form, all field has the required validation and number of characters is restricted to all field except CardOwnerName
. While validating Angular form fields, we can use auto-generated classes/attributes for showing validation error indications. Auto-generated classes/attributes by Angular.
ng-invalid (class) orinvalid (property) | X | ng-valid (class) orvalid (property) |
ng-untouched (class) oruntouched (property) | X | ng-touched (class) ortouched (property) |
To indicate validation error, we conditionally applied CSS class – invalid
using the above properties invalid
and touched
. Finally, the submit button is conditionally disabled based on whether the form as a whole is valid or not.
Currently our Angular Form in payment-detail-form
component looks like this.
Insert a new Record
let’s implement submit event for the form.
Now define the function – onSubmit
inside payment-detail-form.component.ts
.
A separate function insertRecord
is defined to insert a new record into the SQL server table.
Before testing this operation, we have to Enable CORS in Asp.Net Core API, .Net Core Web API will block request from another application which is hosted in another domain or in another port number. by default, Angular is running at port number 4200 and Web API is hosted at a different port number. to make Http Request, we’ve to Enable-CORS (Cross Origin Resource Sharing) in Web API for the port 4200.
You just need to update Startup
class like this.
Inside the Configure function, it is better to keep the function call UseCors
before any other lines. Now you can try the insert operation. for me, it is working fine. Comment if you face any problem.
Retrieve and Display all Inserted Records
Inserted records can be retrieved and displayed in payment-details component, for that let’s update the component typescript file as follows.
Inside list component ngOnInit
lifecycle hook, we’ve called refreshList
function to populate list
array in service class. using service list
property, we can render all of the inserted records in payment-details component html. So update the table div
as follow.
Update and Delete Operation
To implement update operation, we’ve added click event for all td
cells as shown below.
Inside the click event function, we have to populate the corresponding selected record inside the form. so add the following function to payment-details component.
Inside the function, we just updated the selected record object into formData
property in service class. since the form is bound to formData
properties, the form field will get populated with corresponding details.
After making required changes in these populated value fields, user can submit the form for the update operation. so we have to handle both insert and update operation inside the same form submit event in payment-detail-form component. hence update the payment-detail-form.component.ts
.
Inside the form, we have a hidden field for paymentDetailId
. Based on its value in submit function, we can decide whether we’ve got an insert/ update operation. insertRecord
is already defined. with updateRecord
function, we will update the corresponding payment-detail record.
Now let’s implement Delete Operation in parent list component. For that add delete button inside that table rows.
update payment-details.component.html as shown below.
Now lets define onDelete
function in payment-details.component.ts.
So that’s all about Angular CRUD operations with ASP.NET Core Web API.
Video Tutorial
In our YouTube channel, we’ve covered the same topic you could watch the same from here.