Take advantage of the IHostedService interface to execute background tasks in your ASP.Net Core applications Credit: Thinkstock We often need to execute background tasks and scheduled jobs in our applications. To implement background tasks in ASP.Net Core, you can take advantage of Azure WebJobs or any of a number of third-party task schedulers like Quartz or Hangfire. In ASP.Net Core, you can implement background tasks as hosted services as well. A hosted service is a class that implements the IHostedService interface and includes the necessary code for running tasks in the background. This article presents a discussion of how we can build hosted services in ASP.Net Core. At the time of this writing, Visual Studio 2019 is available for free download. If you don’t already have a copy of Visual Studio 2019 installed in your system, you can download it from Microsoft’s Visual Studio downloads page. Create an ASP.Net Core project in Visual Studio First off, let’s create an ASP.Net Core project in Visual Studio. To do that, follow the steps given below to create a new ASP.Net Core project in Visual Studio 2019. Launch the Visual Studio IDE. Click on “Create new project.” In the “Create new project” window, select “ASP.Net Core Web Application” from the list of the templates displayed. Click Next. In the “Configure your new project” window, specify the name and location for the new project. Click Create. In the “Create New ASP.Net Core Web Application” window, select .Net Core as the runtime and ASP.Net Core 2.2 (or later) from the drop-down list at the top. Select “Web Application” as the project template. Ensure that the check boxes “Enable Docker Support” and “Configure for HTTPS” are unchecked as we won’t be using those features here. Ensure that Authentication is set as “No Authentication” as we won’t be using authentication either. Click Create. This would create a new ASP.Net Core project in Visual Studio. We’ll use this project in the subsequent sections of this article to build our custom hosted service. Create a hosted service in ASP.Net Core To create our hosted service, we’ll implement the IHostedService interface. Here is what the IHostedService interface looks like: public interface IHostedService { Task StartAsync(CancellationToken cancellationToken); Task StopAsync(CancellationToken cancellationToken); } In this section we’ll create a minimalistic implementation of a hosted service in ASP.Net Core. To create a new hosted service, follow these steps. Select the project in the Solution Explorer window. Right-click and select “Add -> Class…” In the “Add New Item” window, specify a name for the class (e.g. MyFirstHostedService). Click Add when done. This will create a new class named MyFirstHostedService in a file of the same name with a “.cs” extension. Now replace the default MyFirstHostedService class with the following code. public class MyFirstHostedService : IHostedService { protected async override Task ExecuteAsync(CancellationToken token) { throw new NotImplementedException(); } } Use the BackgroundService class in ASP.Net Core An abstract helper class called BackgroundService is available in .Net Core that already implements the IHostedService interface. Let’s rewrite our code to extend this class. public class MyFirstHostedService : BackgroundService { protected async override Task ExecuteAsync(CancellationToken token) { throw new NotImplementedException(); } } You can examine the source code of the BackgroundService class on GitHub. The following code snippet illustrates a simple method to log the current time in a text file. This method will be called from our hosted service. private async Task Log() { using (StreamWriter sw = new StreamWriter(@"D:log.txt",true)) { await sw.WriteLineAsync (DateTime.Now.ToLongTimeString()); } } Use the ExecuteAsync method in ASP.Net Core Here is the implementation of the ExecuteAsync method. Note how the Log method we created above is called from this method at regular intervals (every second to be precise). protected async override Task ExecuteAsync (CancellationToken token) { while (!token.IsCancellationRequested) { await Log(); await Task.Delay(1000, token); } } And here is the complete source code of the MyFirstHostedService for your reference. using Microsoft.Extensions.Hosting; using System; using System.IO; using System.Threading; using System.Threading.Tasks; namespace HostedServicesApp { public class MyFirstHostedService : BackgroundService { protected async override Task ExecuteAsync(CancellationToken token) { while (!token.IsCancellationRequested) { await Log(); await Task.Delay(1000, token); } } private async Task Log() { using (StreamWriter sw = new StreamWriter(@"D:log.txt",true)) { await sw.WriteLineAsync (DateTime.Now.ToLongTimeString()); } } } } Register the hosted service in ASP.Net Core Lastly, you should register the hosted service in the Startup class as shown in the code snippet below. public void ConfigureServices(IServiceCollection services) { services.AddHostedService<MyFirstHostedService>(); services.AddMvc().SetCompatibilityVersion (CompatibilityVersion.Version_2_2); } Now when you run this ASP.Net Core application, a log file will be created at the location specified and the current time will be logged every second. The IHostedService interface can be used to start or stop background tasks in an ASP.Net Core web application. You can take advantage of this interface to implement your own custom hosted service with the ability to cancel and shut down gracefully if need be. A typical use case for using a hosted service might be executing background tasks to update some content or data in your application. Offloading this activity to a background thread will ensure that the main request thread is not blocked. Related content how-to How to use FastEndpoints in ASP.NET Core Take advantage of the free open-source FastEndpoints library to build fast and lean APIs in your ASP.NET Core applications. By Joydip Kanjilal Jul 11, 2024 7 mins Microsoft .NET C# Development Libraries and Frameworks how-to How to use Refit to consume APIs in ASP.NET Core Take advantage of Refit REST library to simplify API consumption and make your code cleaner, more efficient, and easier to maintain. By Joydip Kanjilal Jul 04, 2024 10 mins C# Microsoft .NET Software Deployment how-to When to use an abstract class vs. interface in C# Understanding the differences between an abstract class and interface is key to designing loosely coupled and extensible applications. By Joydip Kanjilal Jun 20, 2024 10 mins Small and Medium Business Microsoft .NET C# how-to 6 security best practices for ASP.NET Core Learn the best practices and built-in safeguards for preventing attacks and protecting sensitive data in your ASP.NET Core web applications. By Joydip Kanjilal Jun 07, 2024 6 mins C# Microsoft .NET Web Development Resources Videos