Getting Started With the ASP.NET Core MVC Template

This tutorials explains how to create a new ASP.NET Core MVC web application using the startup template, configure and run it.

Creating a New Project

This tutorial uses ABP CLI to create a new project. See the Get Started page for other options.

Install the ABP CLI using a command line window, if you've not installed before:

dotnet tool install -g Volo.Abp.Cli

Use abp new command in an empty folder to create your project:

abp new Acme.BookStore

You can use different level of namespaces; e.g. BookStore, Acme.BookStore or Acme.Retail.BookStore.

new command creates a layered MVC application with Entity Framework Core as the database provider. However, it has additional options. See the CLI documentation for all available options.

Pre Requirements

The created solution requires;

The Solution Structure

Open the solution in Visual Studio:

bookstore-visual-studio-solution

The solution has a layered structure (based on Domain Driven Design) and contains unit & integration test projects properly configured to work with EF Core & SQLite in-memory database.

See MVC application template document to understand the solution structure in details.

Database Connection String

Check the connection string in the appsettings.json file under the .Web project:

{
  "ConnectionStrings": {
    "Default": "Server=localhost;Database=BookStore;Trusted_Connection=True"
  }
}

The solution is configured to use Entity Framework Core with MS SQL Server. EF Core supports various database providers, so you can use another DBMS if you want. Change the connection string if you need.

Create Database & Apply Database Migrations

You have two options to create the database.

Using the DbMigrator Application

The solution contains a console application (named Acme.BookStore.DbMigrator in this sample) that can create database, apply migrations and seed initial data. It is useful on development as well as on production environment.

.DbMigrator project has its own appsettings.json. So, if you have changed the connection string above, you should also change this one.

Right click to the .DbMigrator project and select Set as StartUp Project:

set-as-startup-project

Hit F5 (or Ctrl+F5) to run the application. It will have an output like shown below:

set-as-startup-project

Using EF Core Update-Database Command

Ef Core has Update-Database command which creates database if necessary and applies pending migrations. Right click to the .Web project and select Set as StartUp Project:

set-as-startup-project

Open the Package Manager Console, select .EntityFrameworkCore.DbMigrations project as the Default Project and run the Update-Database command:

pcm-update-database

This will create a new database based on the configured connection string.

Using the .Migrator tool is the suggested way, because it also seeds the initial data to be able to properly run the web application.

Running the Application

Ensure that the .Web project is the startup project. Run the application which will open the home page in your browser:

bookstore-homepage

Click the Login button, enter admin as the username and 1q2w3E* as the password to login to the application.

The startup template includes the identity management and tenant management modules. Once you login, the Administration menu will be available where you can manage tenants, roles, users and their permissions. User management page is shown below:

bookstore-user-management

What's Next?

In this document