Kck.BackgroundJobs.Hangfire
4.8.0
dotnet add package Kck.BackgroundJobs.Hangfire --version 4.8.0
NuGet\Install-Package Kck.BackgroundJobs.Hangfire -Version 4.8.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Kck.BackgroundJobs.Hangfire" Version="4.8.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Kck.BackgroundJobs.Hangfire" Version="4.8.0" />
<PackageReference Include="Kck.BackgroundJobs.Hangfire" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Kck.BackgroundJobs.Hangfire --version 4.8.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Kck.BackgroundJobs.Hangfire, 4.8.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Kck.BackgroundJobs.Hangfire@4.8.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Kck.BackgroundJobs.Hangfire&version=4.8.0
#tool nuget:?package=Kck.BackgroundJobs.Hangfire&version=4.8.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Kck.BackgroundJobs.Hangfire
Hangfire-backed IJobScheduler implementation for reliable background job processing with persistent storage and a built-in dashboard.
Installation
dotnet add package Kck.BackgroundJobs.Hangfire
Quick Start
using Hangfire;
using Kck.BackgroundJobs.Abstractions;
// Program.cs - in-memory storage by default; plug in a durable one with ConfigureStorage
builder.Services.AddKckBackgroundJobsHangfire(options =>
{
options.WorkerCount = 4;
// options.ConfigureStorage = config => config.UseSqlServerStorage(connectionString); // Hangfire.SqlServer (4.7.0+)
});
builder.Services.AddKckJob<WelcomeEmailJob>();
public sealed class WelcomeEmailJob(ILogger<WelcomeEmailJob> logger) : IBackgroundJob
{
public Task ExecuteAsync(CancellationToken ct = default)
{
logger.LogInformation("Sending welcome emails");
return Task.CompletedTask;
}
}
// Schedule a job (Hangfire accepts the 5-field CronExpressions constants)
public sealed class JobSetup(IJobScheduler scheduler)
{
public async Task StartAsync(CancellationToken ct)
{
await scheduler.EnqueueAsync<WelcomeEmailJob>(ct);
await scheduler.AddOrUpdateRecurringAsync<WelcomeEmailJob>("welcome", CronExpressions.EveryHour, ct);
}
}
// The dashboard is in the Hangfire.AspNetCore package: app.UseHangfireDashboard("/jobs") with an authorization filter.
Configuration
| Property | Description | Default |
|---|---|---|
StorageType |
InMemory (the only built-in storage) |
"InMemory" |
ConfigureStorage |
Plugs in another Hangfire storage, e.g. c => c.UseSqlServerStorage(...) (4.7.0+) |
null |
WorkerCount |
Hangfire server worker count | Environment.ProcessorCount |
The dashboard is in Hangfire.AspNetCore, which this package does not reference.
Resources
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net10.0
- Hangfire (>= 1.8.25)
- Hangfire.InMemory (>= 1.0.0)
- Kck.BackgroundJobs.Abstractions (>= 4.8.0)
- Newtonsoft.Json (>= 13.0.4)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.