MVC Framework Tutorial
MVC Framework Tutorial
Audience
This tutorial is targeted for .NET programmers beginning to learn MVC framework. This
tutorial will bring you to intermediate level of knowledge in MVC, covering all the important
aspects of MVC Framework with complete hands-on code experience.
Prerequisites
Before proceeding with this tutorial, we assume the readers have a basic knowledge of
ASP.NET development (C# and VB language) and Visual Studio software installed on their
system.
All the content and graphics published in this e-book are the property of Tutorials Point (I)
Pvt. Ltd. The user of this e-book is prohibited to reuse, retain, copy, distribute or republish
any contents or a part of contents of this e-book in any manner without written consent
of the publisher.
We strive to update the contents of our website and tutorials as timely and as precisely as
possible, however, the contents may contain inaccuracies or errors. Tutorials Point (I) Pvt.
Ltd. provides no guarantee regarding the accuracy, timeliness or completeness of our
website or its contents including this tutorial. If you discover any errors on our website or
in this tutorial, please notify us at [email protected].
i
MVC Framework
Table of Contents
About the Tutorial .................................................................................................................................. i
Audience ................................................................................................................................................ i
Prerequisites .......................................................................................................................................... i
MVC Components.................................................................................................................................. 1
Content Folder..................................................................................................................................... 20
ii
MVC Framework
iii
MVC Framework – Introduction
MVC Components
Following are the components of MVC:
Model
The Model component corresponds to all the data-related logic that the user works with.
This can represent either the data that is being transferred between the View and
Controller components or any other business logic-related data. For example, a Customer
object will retrieve the customer information from the database, manipulate it and update
it data back to the database or use it to render data.
View
The View component is used for all the UI logic of the application. For example, the
Customer view will include all the UI components such as text boxes, dropdowns, etc. that
the final user interacts with.
Controller
Controllers act as an interface between Model and View components to process all the
business logic and incoming requests, manipulate data using the Model component and
interact with the Views to render the final output. For example, the Customer controller
1
MVC Framework
will handle all the interactions and inputs from the Customer View and update the database
using the Customer Model. The same controller will be used to view the Customer data.
ASP.NET MVC
ASP.NET supports three major development models: Web Pages, Web Forms and MVC
(Model View Controller). ASP.NET MVC framework is a lightweight, highly testable
presentation framework that is integrated with the existing ASP.NET features, such as
master pages, authentication, etc. Within .NET, this framework is defined in the
System.Web.Mvc assembly. The latest version of the MVC Framework is 5.0. We use Visual
Studio to create ASP.NET MVC applications which can be added as a template in Visual
Studio.
Provides an extensible and pluggable framework, which can be easily replaced and
customized. For example, if you do not wish to use the in-built Razor or ASPX View
Engine, then you can use any other third-party view engines or even customize the
existing ones.
Supports all the existing vast ASP.NET functionalities, such as Authorization and
Authentication, Master Pages, Data Binding, User Controls, Memberships, ASP.NET
Routing, etc.
Does not use the concept of View State (which is present in ASP.NET). This helps
in building applications, which are lightweight and gives full control to the
developers.
Thus, you can consider MVC Framework as a major framework built on top of ASP.NET
providing a large set of added functionality focusing on component-based development
and testing.
2
MVC Framework – Architecture MVC Framework
In the last chapter, we studied the high-level architecture flow of MVC Framework. Now
let us take a look at how the execution of an MVC application takes place when there is a
certain request from the client. The following diagram illustrates the flow.
3
MVC Framework
Flow Steps
Step 1: The client browser sends request to the MVC Application.
Step 2: Global.ascx receives this request and performs routing based on the URL of the
incoming request using the RouteTable, RouteData, UrlRoutingModule and
MvcRouteHandler objects.
Step 3: This routing operation calls the appropriate controller and executes it using the
IControllerFactory object and MvcHandler object's Execute method.
Step 4: The Controller processes the data using Model and invokes the appropriate
method using ControllerActionInvoker object
Step 5: The processed Model is then passed to the View, which in turn renders the final
output.
4
MVC Framework – ASP.NET Forms MVC Framework
MVC and ASP.NET Web Forms are inter-related yet different models of development,
depending on the requirement of the application and other factors. At a high level, you
can consider that MVC is an advanced and sophisticated web application framework
designed with separation of concerns and testability in mind. Both the frameworks have
their advantages and disadvantages depending on specific requirements. This concept can
be visualized using the following diagram:
5
MVC Framework
Comparison Table
6
MVC Framework – First Application MVC Framework
Let us jump in and create our first MVC application using Views and Controllers. Once we
have a small hands-on experience on how a basic MVC application works, we will learn all
the individual components and concepts in the coming chapters.
7
MVC Framework
Step 2: This will open the Project Template option. Select Empty template and View
Engine as Razor. Click OK.
8
MVC Framework
Now, Visual Studio will create our first MVC project as shown in the following screenshot.
Step 3: Now we will create the first Controller in our application. Controllers are just
simple C# classes, which contains multiple public methods, known as action methods. To
add a new Controller, right-click the Controllers folder in our project and select Add ->
Controller. Name the Controller as HomeController and click Add.
9
MVC Framework
This will create a class file HomeController.cs under the Controllers folder with the
following default code.
using System;
using System.Web.Mvc;
namespace FirstMVCApplication.Controllers
{
public class HomeController : Controller
{
public ViewResult Index()
{
return View();
}
}
}
10
MVC Framework
The above code basically defines a public method Index inside our HomeController and
returns a ViewResult object. In the next steps, we will learn how to return a View using
the ViewResult object.
Step 4: Now we will add a new View to our Home Controller. To add a new View, right-
click view folder and click Add ->View.
11
MVC Framework
Step 5: Name the new View as Index and View Engine as Razor (SCHTML). Click Add.
12
MVC Framework
This will add a new cshtml file inside Views/Home folder with the following code:
@{
Layout = null;
}
<html>
<head>
<meta name="viewport" content="width=device-width" />
<title>Index</title>
</head>
<body>
<div>
</div>
</body>
</html>
Step 6: Modify the above View's body content with the following code:
<body>
<div>
Welcome to My First MVC Application (<b>From Index View</b>)
</div>
</body>
Step 7: Now run the application. This will give you the following output in the browser.
This output is rendered based on the content in our View file. The application first calls the
Controller which in turn calls this View and produces the output.
In Step 7, the output we received was based on the content of our View file and had no
interaction with the Controller. Moving a step forward, we will now create a small example
to display a Welcome message with the current time using an interaction of View and
Controller.
13
MVC Framework
Step 8: MVC uses the ViewBag object to pass data between Controller and View. Open
the HomeController.cs and edit the Index function to the following code.
ViewBag.Greeting =
hour < 12
? "Good Morning. Time is" + DateTime.Now.ToShortTimeString()
: "Good Afternoon. Time is " + DateTime.Now.ToShortTimeString();
return View();
}
In the above code, we set the value of the Greeting attribute of the ViewBag object. The
code checks the current hour and returns the Good Morning/Afternoon message
accordingly using return View() statement. Note that here Greeting is just an example
attribute that we have used with ViewBag object. You can use any other attribute name
in place of Greeting.
Step 9: Open the Index.cshtml and copy the following code in the body section.
<body>
<div>
@ViewBag.Greeting (<b>From Index View</b>)
</div>
</body>
In the above code, we are accessing the value of Greeting attribute of the ViewBag object
using @ (which would be set from the Controller).
Step 10: Now run the application again. This time our code will run the Controller first,
set the ViewBag and then render it using the View code. Following will be the output.
14
MVC Framework – Folders MVC Framework
Now that we have already created a sample MVC application, let us understand the folder
structure of an MVC project. We will create new a MVC project to learn this.
In your Visual Studio, open File -> New -> Project and select ASP.NET MVC Application.
Name it as MVCFolderDemo.
Click OK. In the next window, select Internet Application as the Project Template and click
OK.
15
MVC Framework
This will create a sample MVC application as shown in the following screenshot.
16
MVC Framework
Note: Files present in this project are coming out of the default template that we have
selected. These may change slightly as per different versions.
Controllers Folder
This folder will contain all the Controller classes. MVC requires the name of all the controller
files to end with Controller.
In our example, the Controllers folder contains two class files: AccountController and
HomeController.
17
MVC Framework
Models Folder
This folder will contain all the Model classes, which are used to work on application data.
In our example, the Models folder contains AccountModels. You can open and look at the
code in this file to see how the data model is created for managing accounts in our
example.
Views Folder
This folder stores the HTML files related to application display and user interface. It
contains one folder for each controller.
In our example, you will see three sub-folders under Views, namely Account, Home and
Shared which contains html files specific to that view area.
18
MVC Framework
App_Start Folder
This folder contains all the files which are needed during the application load.
For e.g., the RouteConfig file is used to route the incoming URL to the correct Controller
and Action.
19
MVC Framework
Content Folder
This folder contains all the static files, such as css, images, icons, etc.
The Site.css file inside this folder is the default styling that the application applies.
Scripts Folder
This folder stores all the JS files in the project. By default, Visual Studio adds MVC, jQuery
and other standard JS libraries.
20
MVC Framework – Models MVC Framework
The component ‘Model’ is responsible for managing the data of the application. It responds
to the request from the view and it also responds to instructions from the controller to
update itself.
Model classes can either be created manually or generated from database entities. We are
going to see a lot of examples for manually creating Models in the coming chapters. Thus
in this chapter, we will try the other option, i.e. generating from the database so that you
have hands-on experience on both the methods.
21
MVC Framework
22
MVC Framework
In the next wizard, choose Generate From Database and click Next. Set the Connection to
your SQL database.
23
MVC Framework
Select your database and click Test Connection. A screen similar to the following will follow.
Click Next.
24
MVC Framework
Select Tables, Views, and Stored Procedures and Functions. Click Finish. You will see the
Model View created as shown in the following screenshot.
25
MVC Framework
The above operations would automatically create a Model file for all the database entities.
For example, the Student table that we created will result in a Model file Student.cs with
the following code:
namespace MvcModelExample.Models
{
using System;
using System.Collections.Generic;
26
MVC Framework – Controllers MVC Framework
Asp.net MVC Controllers are responsible for controlling the flow of the application
execution. When you make a request (means request a page) to MVC application, a
controller is responsible for returning the response to that request. The controller can
perform one or more actions. The controller action can return different types of action
results to a particular request.
The Controller is responsible for controlling the application logic and acts as the coordinator
between the View and the Model. The Controller receives an input from the users via the
View, then processes the user's data with the help of Model and passes the results back
to the View.
Create a Controller
To create a Controller –
Step 1: Create an MVC Empty Application and then right-click on the Controller folder in
your MVC application.
Step 2: Select the menu option Add->Controller. After selection, the Add Controller dialog
is displayed. Name the Controller as DemoController.
27
MVC Framework
This is a very simple interface. The sole method, Execute, is invoked when a request is
targeted at the controller class. The MVC Framework knows which controller class has
been targeted in a request by reading the value of the controller property generated by
the routing data.
28
MVC Framework
Step 1: Add a new class file and name it as DemoCustomController. Now modify this class
to inherit IController interface.
Step 3: Run the application and you will receive the following output.
29
MVC Framework – Views MVC Framework
As seen in the initial introductory chapters, View is the component involved with the
application's User Interface. These Views are generally bind from the model data and have
extensions such as html, aspx, cshtml, vbhtml, etc. In our First MVC Application, we had
used Views with Controller to display data to the final user. For rendering these static and
dynamic content to the browser, MVC Framework utilizes View Engines. View Engines are
basically markup syntax implementation, which are responsible for rendering the final
HTML to the browser.
Razor Engine: Razor is a markup syntax that enables the server side C# or VB code into
web pages. This server side code can be used to create dynamic content when the web
page is being loaded. Razor is an advanced engine as compared to ASPX engine and was
launched in the later versions of MVC.
ASPX Engine: ASPX or the Web Forms engine is the default view engine that is included
in the MVC Framework since the beginning. Writing a code with this engine is similar to
writing a code in ASP.NET Web Forms.
Following are small code snippets comparing both Razor and ASPX engine.
Razor:
ASPX:
Out of these two, Razor is an advanced View Engine as it comes with compact syntax, test
driven development approaches, and better security features. We will use Razor engine in
all our examples since it is the most dominantly used View engine.
These View Engines can be coded and implemented in following two types:
Strongly typed
Dynamic typed
These approaches are similar to early-binding and late-binding respectively in which the
models will be bind to the View strongly or dynamically.
30
MVC Framework
using System.Collections.Generic;
using System.Web.Mvc;
namespace ViewsInMVC.Controllers
{
public class ViewDemoController : Controller
{
public class Blog
{
public string Name;
public string URL;
}
31
MVC Framework
};
In the above code, we have two action methods defined: StronglyTypedIndex and
IndexNotStonglyTyped. We will now add Views for these action methods.
Right-click on StonglyTypedIndex action method and click Add View. In the next window,
check the 'Create a strongly-typed view' checkbox. This will also enable the Model Class
and Scaffold template options. Select List from Scaffold Template option. Click Add.
32
MVC Framework
A View file similar to the following screenshot will be created. As you can note, it has
included the ViewDemoController's Blog model class at the top. You will also be able to
use IntelliSense in your code with this approach.
33
MVC Framework
34
MVC Framework
@model dynamic
@{
ViewBag.Title = "IndexNotStonglyTyped";
}
35
MVC Framework
<p>
<ul>
@foreach (var blog in Model) {
<li>
<a href="@blog.URL">@blog.Name</a>
</li>
}
</ul>
</p>
As you can see in the above code, this time it did not add the Blog model to the View as
in the previous case. Also, you would not be able to use IntelliSense this time because this
time the binding will be done at run-time.
Strongly typed Views is considered as a better approach since we already know what data
is being passed as the Model unlike dynamic typed Views in which the data gets bind at
runtime and may lead to runtime errors, if something changes in the linked model.
36
MVC Framework – Layouts MVC Framework
Layouts are used in MVC to provide a consistent look and feel on all the pages of our
application. It is the same as defining the Master Pages but MVC provides some more
functionalities.
37
MVC Framework
Step 2: Create a Style Sheet file named MyStyleSheet.css under the CONTENT folder. This
CSS file will contain all the CSS classes necessary for a consistent web application page
design.
38
MVC Framework
39
MVC Framework
Step 4: Create a MasterLayout.cshtml file under the Shared folder. The file
MasterLayout.cshtml represents the layout of each page in the application. Right-click on
the Shared folder in the Solution Explorer, then go to Add item and click View. Copy the
following layout code.
40
MVC Framework
Layout Code
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<title>@ViewBag.Title - Tutorial Point</title>
<link href="~/favicon.ico" rel="shortcut icon" type="image/x-icon" />
<link rel="stylesheet"
href="@Url.Content("~/Content/MyStyleSheet.css")" />
</head>
<body>
<header>
<div class="content-wrapper">
<div class="float-left">
<p class="site-title">
@Html.ActionLink("Tutorial Point", "Index", "Home")
</p>
</div>
<div class="float-right">
<nav>
<ul id="menu">
41
MVC Framework
<div id="body">
@RenderSection("featured", required: false)
<section class="content-wrapper main-content clear-fix">
@RenderBody()
</section>
</div>
<footer>
<div class="content-wrapper">
<div class="float-left">
<p>© @DateTime.Now.Year - Tutorial Point</p>
</div>
</div>
</footer>
</body>
</html>
In this layout, we are using an HTML helper method and some other system-defined
methods, hence let's look at these methods one by one.
Url.Content(): This method specifies the path of any file that we are using in our
View code. It takes the virtual path as input and returns the absolute path.
Html.ActionLink(): This method renders HTML links that links to action of some
controller. The first parameter specifies the display name, the second parameter
specifies the Action name, and the third parameter specifies the Controller name.
42
MVC Framework
Step 5: Finally, open the _ViewStart.cshtml file inside Views folder and add the following
code:
@{
Layout = "~/Views/Shared/_Layout.cshtml";
}
If the file is not present, you can create the file with this name.
Step 6: Run the application now to see the modified home page.
43
MVC Framework ─ Routing Engine MVC Framework
ASP.NET MVC Routing enables the use of URLs that are descriptive of the user actions and
are more easily understood by the users. At the same time, Routing can be used to hide
data which is not intended to be shown to the final user.
For example, in an application that does not use routing, the user would be shown the URL
as http://myapplication/Users.aspx?id=1 which would correspond to the file Users.aspx
inside myapplication path and sending ID as 1, Generally, we would not like to show such
file names to our final user.
To handle MVC URLs, ASP.NET platform uses the routing system, which lets you create
any pattern of URLs you desire, and express them in a clear and concise manner. Each
route in MVC contains a specific URL pattern. This URL pattern is compared to the incoming
request URL and if the URL matches this pattern, it is used by the routing engine to further
process the request.
http://servername/Products/Phones
In the above URL, Products is the first segment and Phone is the second segment which
can be expressed in the following format:
{controller}/{action}
The MVC framework automatically considers the first segment as the Controller name and
the second segment as one of the actions inside that Controller.
Note: If the name of your Controller is ProductsController, you would only mention
Products in the routing URL. The MVC framework automatically understands the Controller
suffix.
44
MVC Framework
routes.MapRoute(
name: "Default",
url: "{controller}/{action}/{id}",
defaults: new { controller = "Home", action = "Index", id =
UrlParameter.Optional }
);
}
}
45
MVC Framework
This RegisterRoutes method is called by the Global.ascx when the application is started.
The Application_Start method under Global.ascx calls this MapRoute function which sets
the default Controller and its action (method inside the Controller class).
To modify the above default mapping as per our example, change the following line of
code:
This setting will pick the ProductsController and call the Phone method inside that.
Similarly, if you have another method such as Electronics inside ProductsController, the
URL for it would be:
http://servername/Products/Electronics
46
MVC Framework – Action Filters MVC Framework
In ASP.NET MVC, controllers define action methods and these action methods generally
have a one-to-one relationship with UI controls, such as clicking a button or a link, etc.
For example, in one of our previous examples, the UserController class contained methods
UserAdd, UserDelete, etc.
However, many times we would like to perform some action before or after a particular
operation. For achieving this functionality, ASP.NET MVC provides a feature to add pre-
and post-action behaviors on the controller's action methods.
Types of Filters
ASP.NET MVC framework supports the following action filters:
Action Filters: Action filters are used to implement logic that gets executed before
and after a controller action executes. We will look at Action Filters in detail in this
chapter.
Result Filters: Result filters contain logic that is executed before and after a view
result is executed. For example, you might want to modify a view result right before
the view is rendered to the browser.
Exception Filters: Exception filters are the last type of filter to run. You can use
an exception filter to handle errors raised by either your controller actions or
controller action results. You also can use exception filters to log errors.
Action filters are one of the most commonly used filters to perform additional data
processing, or manipulating the return values or cancelling the execution of action or
modifying the view structure at run time.
Action Filters
Action Filters are additional attributes that can be applied to either a controller section or
the entire controller to modify the way in which an action is executed. These attributes
are special .NET classes derived from System.Attribute which can be attached to classes,
methods, properties, and fields.
Output Cache: This action filter caches the output of a controller action for a
specified amount of time.
Handle Error: This action filter handles errors raised when a controller action
executes.
47
MVC Framework
Authorize: This action filter enables you to restrict access to a particular user or
role.
Now, we will see the code example to apply these filters on an example controller
ActionFilterDemoController. (ActionFilterDemoController is just used as an example. You
can use these filters on any of your controllers.)
Output Cache
Example: Specifies the return value to be cached for 10 seconds.
}
}
Handle Error
Example: Redirects application to a custom error page when an error is triggered by the
controller.
[HandleError]
public class ActionFilterDemoController : Controller
{
public ActionResult Index()
{
throw new NullReferenceException();
}
48
MVC Framework
With the above code, if any error happens during the action execution, it will find a view
named Error in the Views folder and render that page to the user.
Authorize
Example: Allowing only authorized users to log in the application.
[Authorize(Roles="admin")]
public ActionResult AdminIndex()
{
ViewBag.Message = "This can be viewed only by users in Admin role only";
return View();
}
}
With the above code, if you would try to access the application without logging in, it will
throw an error similar to the one shown in the following screenshot.
49
MVC Framework – Advanced Example MVC Framework
In the first chapter, we learnt how Controllers and Views interact in MVC. In this tutorial,
we are going to take a step forward and learn how to use Models and create an advanced
application to create, edit, delete. and view the list of users in our application.
50
MVC Framework
This will create a new solution project as shown in the following screenshot. Since we are
using the default ASP.NET theme, it comes with sample Views, Controllers, Models and
other files.
Step 2: Build the solution and run the application to see its default output as shown in
the following screenshot.
Step 3: Add a new model which will define the structure of users data. Right-click on
Models folder and click Add -> Class. Name this as UserModel and click Add.
51
MVC Framework
using System;
using System.ComponentModel;
using System.ComponentModel.DataAnnotations;
using System.Web.Mvc.Html;
namespace AdvancedMVCApplication.Models {
52
MVC Framework
[Required]
public int Id { get; set; }
[DisplayName("First Name")]
[Required(ErrorMessage = "First name is required")]
public string FirstName { get; set; }
[Required]
public string LastName { get; set; }
[Required]
[StringLength(50)]
public string Email { get; set; }
[DataType(DataType.Date)]
public DateTime DOB { get; set; }
[Range(100,1000000)]
public decimal Salary { get; set; }
}
}
In the above code, we have specified all the parameters that the User model has, their
data types and validations such as required fields and length.
Now that we have our User Model ready to hold the data, we will create a class file
Users.cs, which will contain methods for viewing users, adding, editing, and deleting users.
Step 5: Right-click on Models and click Add -> Class. Name it as Users. This will create
users.cs class inside Models. Copy the following code in the users.cs class.
using System;
using System.Collections.Generic;
using System.EnterpriseServices;
namespace AdvancedMVCApplication.Models {
53
MVC Framework
54
MVC Framework
if (usrlst.Id == userModel.Id) {
UserList.Remove(usrlst);
break;
}
}
}
}
}
Once we have our UserModel.cs and Users.cs, we will add Views to our model for viewing
users, adding, editing and deleting users. First let us create a View to create a user.
Step 6: Right-click on the Views folder and click Add -> View.
Step 7: In the next window, select the View Name as UserAdd, View Engine as Razor and
select the Create a strongly-typed view checkbox.
55
MVC Framework
Step 8: Click Add. This will create the following CSHML code by default as shown below:
@model AdvancedMVCApplication.Models.UserModels
@{
ViewBag.Title = "UserAdd";
}
56
MVC Framework
<h2>UserAdd</h2>
@using (Html.BeginForm()) {
@Html.ValidationSummary(true)
<fieldset>
<legend>UserModels</legend>
57
MVC Framework
</div>
<p>
<input type = "submit" value = "Create" />
</p>
</fieldset>
}
<div>
@Html.ActionLink("Back to List", "Index")
</div>
@section Scripts {
58
MVC Framework
@Scripts.Render("~/bundles/jqueryval")
}
As you can see, this view contains view details of all the attributes of the fields including
their validation messages, labels, etc. This View will look like the following in our final
application.
Similar to UserAdd, now we will add four more Views given below with the given code:
Index.cshtml
This View will display all the users present in our system on the Index page.
@model IEnumerable<AdvancedMVCApplication.Models.UserModels>
@{
ViewBag.Title = "Index";
}
<h2>Index</h2>
<p>
59
MVC Framework
<table>
<tr>
<th>
@Html.DisplayNameFor(model => model.FirstName)
</th>
<th>
@Html.DisplayNameFor(model => model.LastName)
</th>
<th>
@Html.DisplayNameFor(model => model.Address)
</th>
<th>
@Html.DisplayNameFor(model => model.Email)
</th>
<th>
@Html.DisplayNameFor(model => model.DOB)
</th>
<th>
@Html.DisplayNameFor(model => model.Salary)
</th>
<th></th>
</tr>
60
MVC Framework
<td>
@Html.DisplayFor(modelItem => item.LastName)
</td>
<td>
@Html.DisplayFor(modelItem => item.Address)
</td>
<td>
@Html.DisplayFor(modelItem => item.Email)
</td>
<td>
@Html.DisplayFor(modelItem => item.DOB)
</td>
<td>
@Html.DisplayFor(modelItem => item.Salary)
</td>
<td>
@Html.ActionLink("Edit", "Edit", new { id=item.Id }) |
@Html.ActionLink("Details", "Details", new { id=item.Id }) |
@Html.ActionLink("Delete", "Delete", new { id=item.Id })
</td>
</tr>
}
</table>
This View will look like the following in our final application.
61
MVC Framework
Details.cshtml
This View will display the details of a specific user when we click on the user record.
@model AdvancedMVCApplication.Models.UserModels
@{
ViewBag.Title = "Details";
}
<h2>Details</h2>
<fieldset>
<legend>UserModels</legend>
62
MVC Framework
</div>
</fieldset>
<p>
63
MVC Framework
This View will look like the following in our final application.
Edit.cshtml
This View will display the edit form to edit the details of an existing user.
@model AdvancedMVCApplication.Models.UserModels
@{
ViewBag.Title = "Edit";
}
<h2>Edit</h2>
@using (Html.BeginForm()) {
@Html.AntiForgeryToken()
@Html.ValidationSummary(true)
<fieldset>
<legend>UserModels</legend>
64
MVC Framework
65
MVC Framework
</div>
<p>
<input type = "submit" value = "Save" />
</p>
</fieldset>
}
<div>
@Html.ActionLink("Back to List", "Index")
</div>
@section Scripts {
@Scripts.Render("~/bundles/jqueryval")
}
66
MVC Framework
Delete.cshtml
This View will display the form to delete the existing user.
@model AdvancedMVCApplication.Models.UserModels
@{
ViewBag.Title = "Delete";
}
<h2>Delete</h2>
<fieldset>
<legend>UserModels</legend>
67
MVC Framework
68
MVC Framework
</div>
</fieldset>
@using (Html.BeginForm()) {
@Html.AntiForgeryToken()
<p>
<input type = "submit" value = "Delete" /> |
@Html.ActionLink("Back to List", "Index")
</p>
}
This View will look like the following in our final application.
Step 9: We have already added the Models and Views in our application. Now finally we
will add a controller for our view. Right-click on the Controllers folder and click Add ->
Controller. Name it as UserController.
69
MVC Framework
By default, your Controller class will be created with the following code:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.Mvc;
using AdvancedMVCApplication.Models;
namespace AdvancedMVCApplication.Controllers {
70
MVC Framework
In the above code, the Index method will be used while rendering the list of users on the
Index page.
Step 10: Right-click on the Index method and select Create View to create a View for our
Index page (which will list down all the users and provide options to create new users).
Step 11: Now add the following code in the UserController.cs. In this code, we are creating
action methods for different user actions and returning corresponding views that we
created earlier.
We will add two methods for each operation: GET and POST. HttpGet will be used while
fetching the data and rendering it. HttpPost will be used for creating/updating data. For
71
MVC Framework
example, when we are adding a new user, we will need a form to add a user, which is a
GET operation. Once we fill the form and submit those values, we will need the POST
method.
[HttpPost]
public ActionResult UserAdd(UserModels userModel) {
_users.CreateUser(userModel);
return View("Index", _users.UserList);
}
[HttpPost]
public ActionResult Details() {
return View("Index", _users.UserList);
}
72
MVC Framework
[HttpPost]
public ActionResult Edit(UserModels userModel) {
_users.UpdateUser(userModel);
return View("Index", _users.UserList);
}
[HttpPost]
public ActionResult Delete(UserModels userModel) {
_users.DeleteUser(userModel);
return View("Index", _users.UserList);
} sers.UserList);
Step 12: Last thing to do is go to RouteConfig.cs file in App_Start folder and change the
default Controller to User.
Step 13: Now run the application. You will be able to see an application as shown in the
following screenshot. You can perform all the functionalities of adding, viewing, editing,
and deleting users as we saw in the earlier screenshots.
73
MVC Framework – Ajax Support MVC Framework
As you might be knowing, Ajax is a shorthand for Asynchronous JavaScript and XML. The
MVC Framework contains built-in support for unobtrusive Ajax. You can use the helper
methods to define your Ajax features without adding a code throughout all the views. This
feature in MVC is based on the jQuery features.
To enable the unobtrusive AJAX support in the MVC application, open the Web.Config file
and set the UnobtrusiveJavaScriptEnabled property inside the appSettings section using
the following code. If the key is already present in your application, you can ignore this
step.
After this, open the common layout file _Layout.cshtml file located under Views/Shared
folder. We will add references to the jQuery libraries here using the following code:
<script src="~/Scripts/jquery-ui-1.8.24.min.js"
type="text/javascript"></script>
<script src="~/Scripts/jquery.unobtrusive-ajax.min.js"
type="text/javascript"></script>
74
MVC Framework
Step 1: Create a Model file Model.cs and copy the following code.
using System;
namespace MVCAjaxSupportExample.Models
{
public class User
{
public int UserId { get; set; }
public string FirstName { get; set; }
public string LastName { get; set; }
public DateTime BirthDate { get; set; }
public Role Role { get; set; }
}
Step 2: Create a Controller file named UserController.cs and create two action methods
inside that using the following code.
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web.Mvc;
using MVCAjaxSupportExample.Models;
namespace MVCAjaxSupportExample.Controllers
75
MVC Framework
{
public class UserController : Controller
{
private readonly User[] userData =
{
new User {FirstName = "Edy", LastName = "Clooney", Role =
Role.Admin},
new User {FirstName = "David", LastName = "Sanderson", Role =
Role.Admin},
new User {FirstName = "Pandy", LastName = "Griffyth", Role =
Role.Normal},
new User {FirstName = "Joe", LastName = "Gubbins", Role =
Role.Normal},
new User {FirstName = "Mike", LastName = "Smith", Role =
Role.Guest}
};
public ActionResult Index()
{
return View(userData);
}
public PartialViewResult GetUserData(string selectedRole = "All")
{
IEnumerable data = userData;
if (selectedRole != "All")
{
var selected = (Role) Enum.Parse(typeof (Role), selectedRole);
data = userData.Where(p => p.Role == selected);
}
return PartialView(data);
}
76
MVC Framework
Step 3: Now create a partial View named GetUserData with the following code. This view
will be used to render list of users based on the selected role from the dropdown.
@model IEnumerable<MVCAjaxSupportExample.Models.User>
<table>
<tr>
<th>
@Html.DisplayNameFor(model => model.FirstName)
</th>
<th>
@Html.DisplayNameFor(model => model.LastName)
</th>
<th>
@Html.DisplayNameFor(model => model.BirthDate)
</th>
<th></th>
</tr>
</td>
</tr>
}
</table>
77
MVC Framework
Step 4: Now create a View GetUser with the following code. This view will asynchronously
get the data from the previously created controller's GetUserData Action.
@using MVCAjaxSupportExample.Models
@model string
@{
ViewBag.Title = "GetUser";
AjaxOptions ajaxOpts = new AjaxOptions {
UpdateTargetId = "tableBody"
};
}
<h2>Get User</h2>
<table>
<thead><tr><th>First</th><th>Last</th><th>Role</th></tr></thead>
<tbody id="tableBody">
@Html.Action("GetUserData", new {selectedRole = Model })
</tbody>
</table>
Step 5: Finally, change the Route.config entries to launch the User Controller.
78
MVC Framework
Step 6: Run the application which will look like the following screenshot.
If you select Admin from the dropdown, it will go and fetch all the users with Admin type.
This is happening via AJAX and does not reload the entire page.
79
MVC Framework – Bundling MVC Framework
Bundling and Minification are two performance improvement techniques that improves
the request load time of the application. Most of the current major browsers limit the
number of simultaneous connections per hostname to six. It means that at a time, all the
additional requests will be queued by the browser.
<system.web>
<compilation debug = "true" />
</system.web>
By default, you will see the debug parameter set to true, which means that bundling and
minification is disabled. Set this parameter to false.
Bundling
To improve the performance of the application, ASP.NET MVC provides inbuilt feature to
bundle multiple files into a single, file which in turn improves the page load performance
because of fewer HTTP requests.
Bundling is a simple logical group of files that could be referenced by unique name and
loaded with a single HTTP request.
By default, the MVC application's BundleConfig (located inside App_Start folder) comes
with the following code −
// The code to bundle other javascript files will also be similar to this
bundles.Add(new StyleBundle("~/Content/themes/base/css").Include(
"~/Content/themes/base/jquery.ui.core.css",
"~/Content/themes/base/jquery.ui.tabs.css",
"~/Content/themes/base/jquery.ui.datepicker.css",
80
MVC Framework
"~/Content/themes/base/jquery.ui.progressbar.css",
"~/Content/themes/base/jquery.ui.theme.css"));
}
The above code basically bundles all the CSS files present in Content/themes/base folder
into a single file.
Minification
Minification is another such performance improvement technique in which it optimizes the
javascript, css code by shortening the variable names, removing unnecessary white
spaces, line breaks, comments, etc. This in turn reduces the file size and helps the
application to load faster.
Thus, if you have a css file named Site.css, it will create its minified version as Site.min.css.
Now when the next time your application will run in the browser, it will bundle and minify
all the css and js files, hence improving the application performance.
81
MVC Framework – Exception Handling MVC Framework
In ASP.NET, error handling is done using the standard try catch approach or using
application events. ASP.NET MVC comes with built-in support for exception handling using
a feature known as exception filters. We are going to learn two approaches here: one with
overriding the onException method and another by defining the HandleError filters.
To understand this approach, create an MVC application (follow the steps covered in
previous chapters). Now add a new Controller class and add the following code which
overrides the onException method and explicitly throws an error in our Action method:
Now let us create a common View named Error which will be shown to the user when any
exception happens in the application. Inside the Views folder, create a new folder called
Shared and add a new View named Error.
82
MVC Framework
83
MVC Framework
If you try to run the application now, it will give the following result. The above code
renders the Error View when any exception occurs in any of the action methods within this
controller.
84
MVC Framework
The advantage of this approach is that multiple actions within the same controller can
share this error handling logic. However, the disadvantage is that we cannot use the same
error handling logic across multiple controllers.
HandleError Attribute
The HandleError Attribute is one of the action filters that we studied in Filters and Action
Filters chapter. The HandleErrorAttribute is the default implementation of IExceptionFilter.
This filter handles all the exceptions raised by controller actions, filters, and views.
To use this feature, first of all turn on the customErrors section in web.config. Open the
web.config and place the following code inside system.web and set its value as On.
<customErrors mode="On"/>
We already have the Error View created inside the Shared folder under Views. This time
change the code of this View file to the following, to strongly-type it with the
HandleErrorInfo model (which is present under System.Web.MVC).
@model System.Web.Mvc.HandleErrorInfo
@{
Layout = null;
}
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width" />
<title>Error</title>
</head>
<body>
<h2>
Sorry, an error occurred while processing your request.
</h2>
<h2>Exception details</h2>
<p>
Controller: @Model.ControllerName <br>
Action: @Model.ActionName
Exception: @Model.Exception
</p>
85
MVC Framework
</body>
</html>
Now place the following code in your controller file which specifies [HandleError] attribute
at the Controller file.
using System;
using System.Data.Common;
using System.Web.Mvc;
namespace ExceptionHandlingMVC.Controllers
{
[HandleError]
public class ExceptionHandlingController : Controller
{
public ActionResult TestMethod()
{
throw new Exception("Test Exception");
return View();
}
}
}
If you try to run the application now, you will get an error similar to shown in the following
screenshot.
As you can see, this time the error contains more information about the Controller and
Action related details. In this manner, the HandleError can be used at any level and across
controllers to handle such errors.
86