Choose Attribute Routing Instead Of Convention Based Routing In ASP.NET MVC

In .NET technology, we have seen lot of different ways to hit some specific resource or URI. In ASP.NET, we use Url Rewriting where as in ASP.NET MVC, there are two more options, first one is Convention Based Routing and other one is Attribute Routing.

What is Convention Based Routing in ASP.NET MVC?

Routing is a mechanism which is used to handle the incoming requests coming from browsers and it represent the particular action rather than any static or physical files. In ASP.NET, the Url hits any resources or files which physically exists but ASP.NET MVC Routing represents action. It is an approach to perform some action based on their definition defined in RouteConfig.cs.

Convention Based Routing

public static void RegisterRoutes(RouteCollection routes)
{
routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
routes.IgnoreRoute("favicon.ico");
routes.IgnoreRoute("Content/img/dotnet-tutorial.ico");
routes.MapRoute("LogOff", "logOff", new
{
controller = "Account", action = "logoff"
});
routes.MapRoute("Register", "register", new
{
controller = "Account", action = "Register"
});
routes.MapRoute("AboutUs", "aboutus", new
{
controller = "Home", action = "AboutUs"
});
routes.MapRoute("IndividualArticlesPost", "articles/{categoryslug}/{url}", new
{
controller = "Articles", action = "View"
}, new
{
categoryslug = @ "\S+", url = @ "\S+"
});
routes.MapRoute("Default", // Route name
"{controller}/{action}/{id}", // URL with parameters
new
{
controller = "Home",
action = "Index",
id = UrlParameter.Optional
});
}

In the above code, you can see three things: “routes”, “IgnoreRoute” and “MapRoute”.

Routes: It is nothing but only a table which is a collection of routes defined in route table. When someone hits some url in the browser, application first check the existing routes table and match with routes.

IgnoreRoute: It is also a collection of url that should be ignored by application.

MapRoute: It is used to add new route into the route table.

routing

Attribute Routing

ASP.NET MVC also supports new type of routing that is called Attribute Routing. In this, attribute participate to route url to particular action.

To enable attribute routing, we need to use MapMvcAttributeRoutes() in the RouteConfig

public class RouteConfig
{
public static void RegisterRoutes(RouteCollection routes)
{
routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
// Attribute Routing
routes.MapMvcAttributeRoutes();
// Convention Based Routing
routes.MapRoute("LogOff", "logOff", new
{
controller = "Account", action = "logoff"
});
routes.MapRoute("Register", "register", new
{
controller = "Account", action = "Register"
});
routes.MapRoute("AboutUs", "aboutus", new
{
controller = "Home", action = "AboutUs"
});
routes.MapRoute("IndividualArticlesPost", "articles/{categoryslug}/{url}", new
{
controller = "Articles", action = "View"
}, new
{
categoryslug = @ "\S+", url = @ "\S+"
});
routes.MapRoute("Default", // Route name
"{controller}/{action}/{id}", // URL with parameters
new
{
controller = "Home",
action = "Index",
id = UrlParameter.Optional
});
}
}

Note: Attribute Routing is configuring before the Convention Routing or simple Routing.

We can use Convention based Routing and Attribute Routing in the same project. Be sure attribute routing should be defined first to convention based routing.

public static void RegisterRoutes(RouteCollection routes)
{
routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
routes.MapMvcAttributeRoutes();
routes.MapRoute(name: "Articles", url: "{controller}/{action}/{id}", defaults: new
{
controller = "Article", action = "Index", id = UrlParameter.Optional
});
routes.MapRoute(name: "Default", url: "{controller}/{action}/{id}", defaults: new
{
controller = "Home", action = "Index", id = UrlParameter.Optional
});
}

Sample Example

The following is a sample example of attribute routing. Here you can see we have used [Route] attribute to route the action with “Home/Index”. When we define the Route attribute, it added route to route table and mapped with specific action.

public class ArticleController: Controller
{
[Route("Home/Index")] //Route: /Home/Index
public ActionResult Index()
{
return View();
}
}

Note: If route URI is not defined in attribute routing then it will work as Convention Routing.

Comman Route Prefix with Attribute Routing

To make your url neat, clear and user friendly, we can define the prefix in URL after domain name. We can use RoutePrefix attribute to define the prefix.

[RoutePrefix("Articles")]
public class ArticleController: Controller
{
[Route("{id}")] //Route: /Articles/13
public ActionResult Details(int id)
{
//other code goes here
}
[Route("{username}")] //Route: /Articles/mukeshkumar
public ActionResult MyArticleDetails(string username)
{
//other code goes here
}
}

Override the common route prefix with Attribute Routing

Sometimes, it is required to show different prefix in url with particular action. If you have already defined the Prefix for the whole controller then you can override it. To override the RoutePrefix, use ~ sign with prefix name with particular action in the Route attribute.

[RoutePrefix("Articles")]
public class ArticleController: Controller
{
[Route("~/ArticleList/{id}")] //Route: /ArticleList/13
public ActionResult Details(int id)
{
//other code goes here
}
}

Route Constraints with Attribute Routing

When we use Route Constraints with Route attribute, it basically restrict or force how parameters will match.

public class ArticleController: Controller
{
[Route("Articles/{id:int}")] //Route: /Articles/13
public ActionResult Details(int id)
{
//other code goes here
}
[Route("Articles/{username}")] //Route: /Articles/mukeshkumar
public ActionResult GetUserDetails(string username)
{
//other code goes here
}
}

In the above code, if you pass integer value as parameter after “Articles/” then it will hit to first route otherwise second.

Attribute Routing in Area of ASP.NET MVC

In we are using Area in ASP.NET MVC project and want to use attribute routing, we need to use RouteArea attribute to define the area name and all will be same.

[RouteArea("Admin")]
[RoutePrefix("Home")]
[Route("{action}")]
public class HomeController: Controller
{
// route: /Admin/Home/Index
public ActionResult Index()
{
return View();
}
// route: /Admin/Home/Employees
[Route("employees")]
public ActionResult GetEmployees()
{
return View();
}
// route: /department
[Route("~/Department")]
public ActionResult Departments()
{
return View();
}
}

Name attribute

As we use Custom Routing in ASP.NET MVC. We can achieve Custom Routing to define the Name of Route and use this route on the basis of Route name.

[Route("Articles", Name = "MyArticle")]
public ActionResult GetAllArticle()
{
}
<a href="@Url.RouteUrl("MyArticle ")">My Article</a>

Which One is the Best

As per our opinion, Attribute Routing provides us more flexibilities as compared to Convention Based Routing. In Attribute Routing, we can manage route as controller level, action level and also area level. Also, it can override the child route, if required.

This is only my opinion; you can try it and see which one is better.

Thanks for reading this article, hope you enjoyed it.

15 Comments

Join the conversation! Your thoughts help the community grow.

Somnath Kumbhar7y ago
Nice article..
Somnath Kumbhar7y ago
Hi Mukesh,
AKshay Raut8y ago
Okay you've explained it simply. I'm still unclear on which one is preferred and why ?
Naveen Bisht10y ago
I have question, if i have both in project Attribute Routing also Convention Routing which will work? and why? also if i have both are same name in this case which will work??
- Vasant Thombre7y ago
  Its depend on the position of routes.MapMvcAttributeRoutes(); if we call it at the start of RegisterRoute method then it enables Attribute Routing
Harshad Pansuriya11y ago
Nice one
Yaduveer Saini11y ago
Nice, Very Helpful for me
Upendra Pratap Shahi11y ago
thanks for sharing...
Banketeshvar Narayan11y ago
Nice Article
Debasis Saha11y ago
Good One..
Mukesh Kumar11y ago
Thanks to all to motivate me.
Jaipal Reddy11y ago
Nice Share Sir.
Humayun Kabir Mamun11y ago
Nice...
Sibeesh Venu11y ago
Nice Share
Ravi Patel11y ago
very well explained mukesh thank you so much for sharing