VOOZH about

URL: https://www.nuget.org/packages/Sparkdo.BackgroundWorkers/

⇱ NuGet Gallery | Sparkdo.BackgroundWorkers 1.0.3



Sparkdo.BackgroundWorkers 1.0.3

There is a newer prerelease version of this package available.
See the version list below for details. 
dotnet add package Sparkdo.BackgroundWorkers --version 1.0.3
 
 
NuGet\Install-Package Sparkdo.BackgroundWorkers -Version 1.0.3
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.3" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Sparkdo.BackgroundWorkers" Version="1.0.3" />
 


 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.3
The NuGet Team does not provide support for this client. Please contact its maintainers for support. 
#r "nuget: Sparkdo.BackgroundWorkers, 1.0.3"
#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.3
#: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.3
 


 Install as a Cake Addin
 

 

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


 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

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

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

扩展性

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

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

代码结构说明

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

核心接口

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

核心实现

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

配置

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

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

Product Versions Compatible and additional computed target framework versions.
.NET net10.0 net10.0 is compatible.  net10.0-android net10.0-android was computed.  net10.0-browser net10.0-browser was computed.  net10.0-ios net10.0-ios was computed.  net10.0-maccatalyst net10.0-maccatalyst was computed.  net10.0-macos net10.0-macos was computed.  net10.0-tvos net10.0-tvos was computed.  net10.0-windows net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (4)

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

Package Downloads
Sparkdo.EventBus

Sparkdo 事件总线实现库，提供本地和分布式事件发布/订阅功能
Sparkdo.BackgroundJobs

Sparkdo 后台作业库，提供后台任务调度和执行功能实现
Sparkdo.BackgroundWorkers.Hangfire

Sparkdo Hangfire 后台工作者库，提供基于 Hangfire 的后台工作者功能集成实现
Sparkdo.BackgroundWorkers.TickerQ

Sparkdo TickerQ 后台工作者库，提供基于 TickerQ 的后台工作者功能集成实现

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.4-preview.3 189 6/8/2026
1.0.4-preview.2 201 6/7/2026
1.0.4-preview.1 187 6/7/2026
1.0.3 454 6/6/2026
1.0.3-preview.1 196 5/17/2026
1.0.2 369 4/27/2026
1.0.2-preview.5 103 4/15/2026
1.0.2-preview.4 118 2/8/2026
1.0.2-preview.3 118 2/1/2026
1.0.2-preview.2 130 1/31/2026
1.0.2-preview.1 198 12/4/2025
1.0.1 1,025 11/27/2025
1.0.0 1,011 11/25/2025
1.0.0-preview.5 151 10/24/2025