In this article I will provide a short Hello World Tutorial using a small Sample Program example on how to use and develop applications in ASP.Net MVC Core 2.1 for the first time.
This article makes use of Visual Studio 2017 for developing the ASP.Net MVC Core 2.1 Hello World Tutorial with Sample Program example.
Creating a new ASP.Net MVC Core 2.1 Project
Let’s get started with creating your first ASP.Net MVC Core 2.1 Project.
1. Open Visual Studio and click on Create New Project.
![ASP.Net MVC Core Hello World Tutorial with Sample Program example]()
2. From the Create new project Dialog window, select ASP.Net Core Web Application option. Then you need to set a suitable Name for your project and also you can set its Location where you want to create the Project.
![ASP.Net MVC Core Hello World Tutorial with Sample Program example]()
3. From the new ASP.Net Core Web Application Dialog, select Empty and click OK.
![ASP.Net MVC Core Hello World Tutorial with Sample Program example]()
4. Your first Hello World ASP.Net Core Web Application Project is now ready and you should see the following folders and files in your Solution Explorer window.
![ASP.Net MVC Core Hello World Tutorial with Sample Program example]()
Downloading MVC Core 2.1 Package from NuGet
This is an Empty Project and hence you will need to install the ASP.Net MVC Core 2.1 package using the following command.
Install-Package Microsoft.AspNetCore.Mvc -Version 2.1.0
![ASP.Net MVC Core Hello World Tutorial with Sample Program example]()
Adding Controller to the ASP.Net MVC Core 2.1 Project
1. Inside the Solution Explorer window, Right Click on the Project and then click Add and then New Folder option from the Context Menu.
![ASP.Net MVC Core Hello World Tutorial with Sample Program example]()
2. Name the newly added Folder as Controllers.
![ASP.Net MVC Core Hello World Tutorial with Sample Program example]()
3. Now, inside the Solution Explorer window, Right Click on the Controllers folder and then click on Add and then Controller option of the Context Menu.
![ASP.Net MVC Core Hello World Tutorial with Sample Program example]()
4. From the Add Scaffold Dialog window, select the “MVC Controller – Empty” option and click Add button.
![ASP.Net MVC Core Hello World Tutorial with Sample Program example]()
5. You will now be asked to provide a suitable Name to the new Controller.
![ASP.Net MVC Core Hello World Tutorial with Sample Program example]()
Once you click add, the following Controller is created. The default Action is “Index”.
![ASP.Net MVC Core Hello World Tutorial with Sample Program example]()
Adding View associated with the Controller to the ASP.Net MVC Core 2.1 Project
1. Now you will need to Right Click inside the Controller class and click on the Add View option in order to create a View for the Controller.
![ASP.Net MVC Core Hello World Tutorial with Sample Program example]()
2. You will need to provide a suitable Name to the View. This article does not use Layout Page and hence the “Use a layout page” CheckBox needs to be kept unchecked.
![ASP.Net MVC Core Hello World Tutorial with Sample Program example]()
Once you click Add Button, the following View is created.
![ASP.Net MVC Core Hello World Tutorial with Sample Program example]()
Configuring the Routes
The last important part is to configure the Routes in the Startup.cs file.
1. Open the Startup.cs class from the Solution Explorer window.
![ASP.Net MVC Core Hello World Tutorial with Sample Program example]()
2. In the Startup.cs there are two methods.
ConfigureServices
Inside this method, you will have to add the following code which will instruct the program to add MVC Services.
public void ConfigureServices(IServiceCollection services)
{
services.AddMvc();
}
Configure
Inside this method, the Route is set and the names of the Controller and the Action method are specified.
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
app.UseMvc(routes =>
{
routes.MapRoute(
name: "default",
template: "{controller=Home}/{action=Index}/{id?}");
});
}
The final Startup.cs file will look as shown below.
![ASP.Net MVC Core Hello World Tutorial with Sample Program example]()
Now press F5 to run the Application and you should see a blank page in browser.
![ASP.Net MVC Core Hello World Tutorial with Sample Program example]()
Displaying a Message from Controller to View in ASP.Net MVC Core 2.1 Project
1. Inside the HomeController’s
Index method, a
ViewBag property named “Message” is set.
public class HomeController : Controller
{
public IActionResult Index()
{
ViewBag.Message = "This is my First MVC Core 2.1 App.";
return View();
}
}
2. The
ViewBag property is displayed in the
View named “Index” as shown below.
@{
Layout = null;
}
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width" />
<title>Index</title>
</head>
<body>
@ViewBag.Message
</body>
</html>
3. Now press F5 to run the application and you should see a message displayed on page in browser.
![ASP.Net MVC Core Hello World Tutorial with Sample Program example]()
Downloads
