In this article I will explain with an example, how to use
Output Parameter with
Stored Procedure using
Dapper library in ASP.Net MVC.
Installing Dapper package using Nuget
Database
I have made use of the following table Customers with the schema as follows.
Note: You can download the database table SQL by clicking the download link below.
Stored Procedure
This
Stored Procedure accepts following parameters which are used to
insert the records:
Name – This is an INPUT Parameter to pass the Name of the Customer.
Country – This is an INPUT Parameter to pass the Country of the Customer.
CustomerId – This is an OUTPUT Parameter to get the last inserted CustomerId.
Note: Output Parameter is identified by the keyword OUTPUT.
CREATE PROCEDURE [Customers_InsertCustomer_Output]
@Name VARCHAR(100),
@Country VARCHAR(50),
@CustomerId INT OUTPUT
AS
BEGIN
INSERT INTO [Customers]
([Name]
,[Country])
VALUES (@Name
,@Country)
SELECT @CustomerId = SCOPE_IDENTITY()
END
Model
The Model class consists of following properties.
public class Customer
{
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;
using System.Data.SqlClient;
using System.Configuration;
Controller
The Controller consists of following Action methods.
Action method for handling GET operation
Inside this Action method, simply the View is returned.
Action method for handling POST operation
This method accepts Customer class object as a parameter.
An object of DynamicParameters is created and CustomerId is added as parameter with its Data Type specified and its Direction is set to Output since by default the Direction of all parameters are Input.
Then, the Name and Country values are also added as parameter.
After that, the
Execute method of
Dapper library is used to fetch
CustomerId of the inserted record from the
Customers Table.
The CustomerId of the inserted record i.e. the output parameter value is fetched using Get method of DynamicParameters class.
Finally, the CustomerId of the inserted record is set and the Customer class object is returned to the View.
public class HomeController : Controller
{
// GET: Home
public ActionResult Index()
{
return View();
}
[HttpPost]
public ActionResult Index(Customer customer)
{
string constr = ConfigurationManager.ConnectionStrings["constr"].ConnectionString;
string spName = "Customers_InsertCustomer_Output";
using (SqlConnection con = new SqlConnection(constr))
{
DynamicParameters dynamicParameters = new DynamicParameters();
// Adding Input parameters.
dynamicParameters.Add("@Name", customer.Name);
dynamicParameters.Add("@Country", customer.Country);
// Adding Output parameter.
dynamicParameters.Add("@CustomerId", dbType: DbType.Int32, direction: ParameterDirection.Output);
con.Execute(spName, dynamicParameters, commandType: CommandType.StoredProcedure);
customer.CustomerId = dynamicParameters.Get<int>("@CustomerId");
}
return View(customer);
}
}
View
Inside the View, in the very first line the Customer class is declared as Model for the View.
The View consists of an HTML Form which has been created using the Html.BeginForm method with the following parameters.
ActionName – Name of the Action. In this case the name is Index.
ControllerName – Name of the Controller. In this case the name is Home.
FormMethod – It specifies the Form Method i.e. GET or POST. In this case it will be set to POST.
The View also consists of an HTML Table, which consists of TextBox and DropDownList created using Html.TextBoxFor and HTML.DropDownListFor methods respectively and a Submit Button.
Inside the View, the following
jQuery script file is inherited.
1. jquery.min.js
Submitting Form
When the
Submit button is clicked the Form is submitted and finally, the
Model is checked for NULL and if it is not NULL then, the value of the
CustomerId is displayed using
JavaScript Alert Message Box.
@model Dapper_Output_Parameter_SP_MVC.Models.Customer
@{
Layout = null;
}
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width" />
<title>Index</title>
</head>
<body>
@using (Html.BeginForm("Index", "Home", FormMethod.Post))
{
<table cellpadding="0" cellspacing="0">
<tr>
<td>Name: </td>
<td>@Html.TextBoxFor(m => m.Name)</td>
</tr>
<tr>
<td>Country: </td>
<td>
@Html.DropDownListFor(m => m.Country, new List<SelectListItem>
{
new SelectListItem { Text = "United States", Value = "United States" },
new SelectListItem { Text = "India", Value = "India" },
new SelectListItem { Text = "France", Value = "France" },
new SelectListItem { Text = "Russia", Value = "Russia" }}, "Please select")
</td>
</tr>
<tr>
<td></td>
<td><input type="submit" value="Submit" /></td>
</tr>
</table>
}
<script type="text/javascript"src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.7.1/jquery.min.js"></script>
@if (Model != null)
{
<script type="text/javascript">
$(function () {
alert("Inserted Customer ID: " + @Model.CustomerId);
});
</script>
}
</body>
</html>
Screenshots
The Form
Record after Insert in database
Downloads