Sparkdo.BackgroundWorkers 1.0.2

.NET 10.0

dotnet add package Sparkdo.BackgroundWorkers --version 1.0.2

NuGet\Install-Package Sparkdo.BackgroundWorkers -Version 1.0.2

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="Sparkdo.BackgroundWorkers" Version="1.0.2" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Sparkdo.BackgroundWorkers" Version="1.0.2" />
                    

                            Directory.Packages.props

<PackageReference Include="Sparkdo.BackgroundWorkers" />
                    

                            Project file

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 Sparkdo.BackgroundWorkers --version 1.0.2

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Sparkdo.BackgroundWorkers, 1.0.2"

#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 Sparkdo.BackgroundWorkers@1.0.2

#: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=Sparkdo.BackgroundWorkers&version=1.0.2
                    

                            Install as a Cake Addin

#tool nuget:?package=Sparkdo.BackgroundWorkers&version=1.0.2
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Sparkdo.BackgroundWorkers

Sparkdo 后台工作者库，提供后台任务执行和管理功能。

功能特性

后台工作者基类：提供后台任务执行的基础实现
后台工作者管理器：统一管理和调度后台工作者
异步周期性任务支持：支持定时执行的后台任务
与 Sparkdo 框架无缝集成
支持依赖注入和生命周期管理

安装

<PackageReference Include="Sparkdo.BackgroundWorkers" Version="x.x.x" />

核心组件

IBackgroundWorker

后台工作者接口，继承自 IRunnable，定义了后台任务的基本行为：

StartAsync(): 启动后台工作者
StopAsync(): 停止后台工作者

BackgroundWorkerBase

后台工作者基类，实现了 IBackgroundWorker 接口：

提供日志记录功能
管理取消令牌
提供服务定位器功能

IBackgroundWorkerManager

后台工作者管理器接口，负责管理所有后台工作者：

AddAsync(): 添加新的后台工作者
StartAsync(): 启动所有后台工作者
StopAsync(): 停止所有后台工作者

DefaultBackgroundWorkerManager

默认后台工作者管理器实现：

维护后台工作者列表
统一管理工作者的启动和停止
支持动态添加工作者

AsyncPeriodicBackgroundWorkerBase

异步周期性后台工作者基类：

支持定时执行的后台任务
自动处理异常和重试
可配置执行间隔

扩展性

该库提供了完整的后台任务管理功能，可以通过以下方式扩展：

继承 BackgroundWorkerBase 实现自定义后台任务
继承 AsyncPeriodicBackgroundWorkerBase 实现定时任务
实现自定义的 IBackgroundWorkerManager 来改变管理策略
通过 SparkdoBackgroundWorkerOptions 配置后台工作者行为

代码结构说明

本项目包含以下主要组件：

核心接口

IBackgroundWorker: 后台工作者接口
IBackgroundWorkerManager: 后台工作者管理器接口

核心实现

BackgroundWorkerBase: 后台工作者基类
DefaultBackgroundWorkerManager: 默认后台工作者管理器
AsyncPeriodicBackgroundWorkerBase: 异步周期性后台工作者基类
AsyncPeriodicBackgroundWorkerContext: 异步周期性任务上下文

配置

SparkdoBackgroundWorkerOptions: 后台工作者配置选项
SparkdoBackgroundWorkersModule: 后台工作者模块配置

所有公共接口和类都添加了详细的 XML 文档注释，便于开发者理解和使用。

Product	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
- JetBrains.Annotations (>= 2025.2.4)
- Microsoft.Extensions.Configuration (>= 10.0.5)
- Microsoft.Extensions.Configuration.CommandLine (>= 10.0.5)
- Microsoft.Extensions.Configuration.EnvironmentVariables (>= 10.0.5)
- Microsoft.Extensions.Configuration.FileExtensions (>= 10.0.5)
- Microsoft.Extensions.Configuration.Json (>= 10.0.5)
- Microsoft.Extensions.Configuration.UserSecrets (>= 10.0.5)
- Microsoft.Extensions.DependencyInjection (>= 10.0.5)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.5)
- Microsoft.Extensions.DependencyModel (>= 10.0.5)
- Microsoft.Extensions.FileProviders.Physical (>= 10.0.5)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.5)
- Microsoft.Extensions.Localization (>= 10.0.5)
- Microsoft.Extensions.Logging (>= 10.0.5)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.5)
- Microsoft.Extensions.Options (>= 10.0.5)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.5)
- Microsoft.Extensions.Options.DataAnnotations (>= 10.0.5)
- Nito.AsyncEx.Context (>= 5.1.2)
- Sparkdo.Threading (>= 1.0.2)
- System.Linq.Dynamic.Core (>= 1.7.1)

NuGet packages (4)

Showing the top 4 NuGet packages that depend on Sparkdo.BackgroundWorkers:

Package	Downloads
Sparkdo.EventBus Sparkdo 事件总线实现库，提供本地和分布式事件发布/订阅功能	3.0K
Sparkdo.BackgroundJobs Sparkdo 后台作业库，提供后台任务调度和执行功能实现	1.3K
Sparkdo.BackgroundWorkers.Hangfire Sparkdo Hangfire 后台工作者库，提供基于 Hangfire 的后台工作者功能集成实现	1.1K
Sparkdo.BackgroundWorkers.TickerQ Sparkdo TickerQ 后台工作者库，提供基于 TickerQ 的后台工作者功能集成实现	1.1K

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
1.0.2	356	4/27/2026
1.0.2-preview.5	95	4/15/2026
1.0.2-preview.4	113	2/8/2026
1.0.2-preview.3	113	2/1/2026
1.0.2-preview.2	124	1/31/2026
1.0.2-preview.1	194	12/4/2025
1.0.1	1,020	11/27/2025
1.0.0	1,006	11/25/2025
1.0.0-preview.5	147	10/24/2025