In the first article in this series, I've made a empty ASP.Net Core project with MVC 6 set up and ready to go.
In this article, I'll be looking to copy content from my existing ASP.Net MVC 5 project.
Steps I missed
I'm using pre-release libraries (pretty much everything) - but I forgot to set the Include Pre-release checkbox on the NuGet Package Manager. Oops.
I missed adding _ViewStart.cshtml - without this I wasn't getting the layouts pulled in.
So these are the steps for this article that I've taken:
- Copy images from old project into wwwroot\images
- Copy site CSS & Less into wwwroot\css
- Update Less files for background URLs (location changes)
- Copy existing models into ViewModels - I've chosen to use ViewModels to temperate from Service (or BLL) models - seems to be good practice
- Update models to reflect ViewModels in namespace
- Copy existing Views
- Update Views to reference the approriate ViewModels
- Update Views to remove Bundle renders (replace with direct loading of css/ js)
- Update Views to replace @Html.ActionLink and @Url.Action with tag helpers (see below)
- Update Views to replace glythicons to Font Awesome
- Copy any Service classes in Services folder
- Update any Services class namespace references
- Copy existing Controllers in Controllers\Web
- Update any Controller class namespace references
- Replace "System.Web.Mvc" with "Microsoft.AspNet.Mvc"
One thing you will notice is that bundling & minification has disappeared. We are going to use Gulp for these, but to keep this article simple I'll set that up in the next article.
"Tag Helpers are a new feature in MVC that you can use for generating HTML. The syntax looks like HTML (elements and attributes) but is processed by Razor on the server. Tag Helpers are in many ways an alternative syntax to Html Helper methods but they also provide some functionality that was either difficult or impossible to do with helper methods." MSDN
In my case, I've replaced @Html.ActionLink & @Url.Action with
<a asp-action="Index" asp-controller="Home" ...
Definitely looks a lot cleaner in the HTML.
In RC1 it appears that Html.RenderPartial hasn't been implemented.
Apparently sorted in in RC2 (see this stack overflow answer).
For now, we just amend to Html.RenderPartialAsync.
I use less for my CSS. ASP.Net Core moves you towards using a build tool to compile your less file to css.
This seems to be aimed at producing better tooling for Continuous Integration pipeline.
The two favourites seem to be Gulp and Grunt.
So which tool to go for?
A quick read of comparisons on the internet indicate that there is a lot of parity between the two. Ultimately it seems that your main choice is between configuration (Grunt) and code (Gulp).
Being a developer at heart, Gulp is my first choice.
For this article, all I need it to do is compile my less files. For this:
Add NPM Configuration (package.json). To which add the following the devDependancies:
- "gulp": "~3.9.1"
- "gulp-less": "~3.0.5"
Add the gulpfile.js - see the check-in for the basic setup
This seemed enough to get me going. This Asp.net article talks you through using Gulp.
Ok, at this point I'm able to compile and run the website. All looks file. You can see it in this commit
In the next article I'm going to look at using more Gulp goodness to minify and bundle.
Labels: ASP.Net Core, MVC 6