Sparkdo.Threading
1.0.2
dotnet add package Sparkdo.Threading --version 1.0.2
NuGet\Install-Package Sparkdo.Threading -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.Threading" Version="1.0.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Sparkdo.Threading" Version="1.0.2" />
<PackageReference Include="Sparkdo.Threading" />
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.Threading --version 1.0.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Sparkdo.Threading, 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.Threading@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.Threading&version=1.0.2
#tool nuget:?package=Sparkdo.Threading&version=1.0.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Sparkdo.Threading
Sparkdo 线程处理库,提供异步计时器、Cron计时器、取消令牌提供者等线程相关的功能。
功能特性
- 异步计时器(AsyncTimer)
- Cron表达式计时器(CronTimer)
- 取消令牌提供者(CancellationTokenProvider)
- 环境数据上下文(EnvironmentDataContext)
- 异步查询执行器(AsyncQueryableExecuter)
- 与 Sparkdo 框架无缝集成
安装
<PackageReference Include="Sparkdo.Threading" Version="x.x.x" />
核心组件
IAsyncTimer
异步计时器接口,继承自 IRunnable 接口:
Period: 计时器的任务周期(以毫秒为单位)Callback: 计时器回调函数StartAsync(): 启动计时器StopAsync(): 停止计时器
ICronTimer
Cron表达式计时器接口,继承自 IRunnable 接口:
Callback: 计时器回调函数Change(): 更改Cron表达式和初始延迟时间StartAsync(): 启动计时器StopAsync(): 停止计时器
ICancellationTokenProvider
取消令牌提供者接口:
CancellationToken: 获取取消令牌Use(): 使用指定的取消令牌
IRunnable
可运行接口,定义了启动和停止服务的方法:
StartAsync(): 启动服务StopAsync(): 停止服务
扩展性
该库提供了完整的线程处理功能实现,可以通过以下方式扩展:
- 实现自定义的
IAsyncTimer来提供特定的计时器逻辑 - 实现自定义的
ICronTimer来提供特定的Cron计时器逻辑 - 实现自定义的
ICancellationTokenProvider来提供特定的取消令牌逻辑
代码结构说明
本项目包含以下主要组件:
计时器相关
IAsyncTimer: 异步计时器接口AsyncTimer: 异步计时器实现ICronTimer: Cron计时器接口CronTimer: Cron计时器实现
取消令牌相关
ICancellationTokenProvider: 取消令牌提供者接口NullCancellationTokenProvider: 空取消令牌提供者实现CancellationTokenProviderBase: 取消令牌提供者基类CancellationTokenProviderExtensions: 取消令牌提供者扩展方法
环境数据相关
IEnvironmentDataContext: 环境数据上下文接口AsyncLocalEnvironmentDataContext: 基于AsyncLocal的环境数据上下文实现IEnvironmentScopeProvider: 环境作用域提供者接口EnvironmentDataContextEnvironmentScopeProvider: 环境数据上下文环境作用域提供者实现
配置
SparkdoThreadingModule: 线程模块配置
所有公共接口和类都添加了详细的 XML 文档注释,便于开发者理解和使用。
| 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
- 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.Core (>= 1.0.2)
- Sparkdo.CrontabQ (>= 1.0.2)
- System.Linq.Dynamic.Core (>= 1.7.1)
NuGet packages (10)
Showing the top 5 NuGet packages that depend on Sparkdo.Threading:
| Package | Downloads |
|---|---|
|
Sparkdo.Caching
Sparkdo 缓存库,提供分布式缓存功能实现 |
|
|
Sparkdo.BackgroundWorkers
Sparkdo 后台工作者库,提供后台任务执行和管理功能 |
|
|
Sparkdo.Auditing
Sparkdo 审计库,提供方法调用和实体变更的自动审计日志记录功能 |
|
|
Sparkdo.BackgroundJobs.Abstractions
Sparkdo 后台作业抽象库,定义后台任务调度和执行的核心接口和基础类型 |
|
|
Sparkdo.BlobStoring
Sparkdo BLOB 存储库,提供统一的二进制大对象存储接口和多种存储提供程序实现 |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.0.2 | 593 | 4/27/2026 |
| 1.0.2-preview.5 | 126 | 4/15/2026 |
| 1.0.2-preview.4 | 135 | 2/8/2026 |
| 1.0.2-preview.3 | 138 | 2/1/2026 |
| 1.0.2-preview.2 | 144 | 1/31/2026 |
| 1.0.2-preview.1 | 205 | 12/4/2025 |
| 1.0.1 | 2,089 | 11/27/2025 |
| 1.0.0 | 1,979 | 11/25/2025 |
| 1.0.0-preview.5 | 142 | 10/24/2025 |