ASP.NET Boilerplate Tutorials

This is a set of tutorials I've created for my junior team using ASP.NET Boilerplate.

These tutorials are also mostly applicable to ABP 3.4.

Prerequisites Tools

• Visual Studio 2017
• VSCode
• NodeJS
• Yarn

Prerequisite Understanding

.NET Core

.NET Core can be thought of as a cross-platform version of the .NET Framework supporting Windows, macOS and Linux, and can be used in device, cloud, and embedded/IoT scenarios. It implements the .NET Standard Library specification.

ASP.NET Core

ASP.NET Core is no longer based on System.Web.dll ASP.NET Core apps can run on .NET Core or on the full .NET Framework

Make sure to install .NET Core 2.0 SDK

Entity Framework Core

The technology formerly known as Entity Framework 7 (EF7) was renamed to Entity Framework Core (EF Core) in early 2016 but can run on the full .NET Framework or on .NET Core.

Angular

Angular is an open-source frontend web application platform

RxJS

RxJS is a library for composing asynchronous and event-based programs by using observable sequences. This article is a very good introduction to reactive programming.

AdminBSB

ABP uses AdminBSB, a free admin panel that is based on Bootstrap 3.x with Material Design. You can find working examples of all the input and components here.

The old template (version 2.0.2) uses ngx-bootstrap which contains all core (but not only) Bootstrap components powered by Angular. This also includes moment.js for parsing and manipulating dates.

ABP API

While not a requisite (since we're coving most of it in depth in this tutorial) the API specification is also available online

Starting Articles

• How to Initialize and Run a Clean Template
• Project Architecture

Deployment

• Deploying to Azure
• Determining Current Tenant - Link to ASP.NET Boilerplate documentation
• Accessing the server log from Azure

Infrastructure Layer

• Creating a Custom Repository
• Writing to the server log file
• Enabling Social Login

Domain Layer

• How to create an entity
• User Manager, Roles & Permissions
• Localization
• Background Jobs

Application Layer

• How to Create an Application Service
• Overriding the CRUD Application Service
• Communicating with the Application Layer
• Using Predefined Permissions
• Integrate ASPNET Core SignalR
• Throwing HTTP Error Codes

Presentation Layer

• Built-in Functions
• Creating modal dialogs
• Updating the Menu (version 2.1.2 only)
• Read URL query parameters
• Including JavaScript libraries
• Using SignalR
• What is the 'clearfix' class for?
• ExpressionChangedAfterItHasBeenCheckedError

Other Articles

• Unit Testing

AppFactory Customizations

• Entity Not Found Exception
• Angular 2 User Profile Self-Help Editor
• Azure Blob Storage Module
• Migration Automation for Continuous Deployment