In this article I will explain with an example, how to insert data into database using Dapper library in ASP.Net Core Razor Pages.
Note: For beginners in ASP.Net Core (.Net Core 7) Razor Pages, please refer my article ASP.Net Core 7 Razor Pages: Hello World Tutorial with Sample Program example.
 
 

Installing Dapper package using Nuget

In order to install Dapper library using Nuget, please refer my article Install Dapper from Nuget in Visual Studio.
 
 

Database

I have made use of the following table Customers with the schema as follows.
Insert using Dapper in ASP.Net Core Razor Pages
 
Note: You can download the database table SQL by clicking the download link below.
           Download SQL file
 
 

Model

The Model class consists of following properties.
public class CustomerModel
{
    public int CustomerId { get; set; }
    public string Name { get; set; }
    public string Country { get; set; }
}
 
 

Namespaces

You will need to import the following namespaces.
using Dapper;
using System.Data.SqlClient;
 
 

Razor PageModel (Code-Behind)

The PageModel consists of following Handler methods.

Handler Method for handling GET operation

This Handler method is left empty as it is not required.
 

Handler Method for handling POST operation

This Handler method accepts CustomerModel class object as a parameter.
Inside this Handler method, first the connection is read from the ConnectionStrings section of the AppSettings.json file.
Note: For more details on how to read Connection String from AppSettings.json, please refer my article .Net Core 7: Read Connection String from AppSettings.json file.
 
Then, the SQL query and CustomerModel class object is passed to the ExecuteScalar method of the Dapper library which then inserts the record in the Customers Table.
Note: For more details on ExecuteScalar method, please refer my article Understanding Dapper ExecuteScalar in C# and VB.Net.
 
Finally, the CustomerId of the inserted record is set.
public class IndexModel : PageModel
{
    public IConfiguration Configuration { get; set; }
 
    public CustomerModel Customer { get; set; }
 
    public IndexModel(IConfiguration configuration)
    {
        this.Configuration = configuration;
    }
    public void OnGet()
    {
    }
 
    public void OnPostSubmit(CustomerModel customer)
    {
        string sql = "INSERT INTO Customers VALUES(@Name, @Country)";
        sql += " SELECT SCOPE_IDENTITY()";
        string constr = this.Configuration.GetSection("ConnectionStrings")["MyConn"];
        using (SqlConnection con = new SqlConnection(constr))
        {
            customer.CustomerId = Convert.ToInt32(con.ExecuteScalar(sql, customer));
            this.Customer = customer;
        }
    }
}
 
 

Razor Page (HTML)

HTML Markup

Inside the Razor Page, the ASP.Net TagHelpers is inherited.
The HTML of Razor Page consists of an HTML Form consisting of an HTML Table, which contains a TextBox, a DropDownList and a Submit Button.
The Submit Button has been set with the POST Handler method using the asp-page-handler attribute.
Note: In the Razor PageModel, the Handler method name is OnPostSubmit but here it will be specified as Submit when calling from the Razor HTML Page.
 
Inside the HTML of Razor Page, the following JS file is inherited.
1. jquery.min.js
 

Submitting the Form

When the Submit Button is clicked then, the CustomerModel class object is checked for NULL and if it is not NULL then, the CustomerId is displayed using JavaScript Alert Message Box.
@page
@model Dapper_Insert_Core_Razor.Pages.IndexModel
@model *, Microsoft.AspNetCore.Mvc.Taghelpers
@{
      Layout = null;
}
 
<!DOCTYPE html>
 
<html>
<head>
      <meta name="viewport" content="width=device-width" />
      <title>Index</title>
</head>
<body>
    <form method="post">
        <table cellpadding="0" cellspacing="0">
            <tr>
                <td>Name: </td>
                <td>
                    <input type="text" asp-for="Customer.Name" />
                </td>
            </tr>
            <tr>
                <td>Country: </td>
                <td>
                    <select asp-for="Customer.Country">
                        <option value="Please select">Please select</option>
                        <option value="United States">United States</option>
                        <option value="India">India</option>
                        <option value="France">France</option>
                        <option value="Russia">Russia</option>
                    </select>
                </td>
            </tr>
            <tr>
                <td></td>
                <td><input type="submit" value="Submit" asp-page-handler="Submit" /></td>
            </tr>
        </table>
    </form>
    <script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.7.1/jquery.min.js"></script>
    @if (Model.Customer != null)
    {
        <script type="text/javascript">
            $(function () {
                alert("Inserted Customer ID: " + @Model.Customer.CustomerId);
            });
        </script>
    }
</body>
</html>
 
 

Screenshots

The Form

Insert using Dapper in ASP.Net Core Razor Pages
 

Record after Insert in database

Insert using Dapper in ASP.Net Core Razor Pages
 
 

Downloads

Download Code