Sparkdo.Threading
1.0.1
.NET 10.0
This package targets .NET 10.0. The package is compatible with this framework or higher.
.NET Standard 2.0
This package targets .NET Standard 2.0. The package is compatible with this framework or higher.
There is a newer prerelease version of this package available.
See the version list below for details.
See the version list below for details.
dotnet add package Sparkdo.Threading --version 1.0.1
NuGet\Install-Package Sparkdo.Threading -Version 1.0.1
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.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Sparkdo.Threading" Version="1.0.1" />
<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.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Sparkdo.Threading, 1.0.1"
#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.1
#: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.1
#tool nuget:?package=Sparkdo.Threading&version=1.0.1
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 | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. 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. |
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
| .NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen40 was computed. tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
.NETStandard 2.0
- JetBrains.Annotations (>= 2025.2.2)
- Microsoft.Bcl.AsyncInterfaces (>= 10.0.0)
- Microsoft.Extensions.Configuration (>= 10.0.0)
- Microsoft.Extensions.Configuration.CommandLine (>= 10.0.0)
- Microsoft.Extensions.Configuration.EnvironmentVariables (>= 10.0.0)
- Microsoft.Extensions.Configuration.FileExtensions (>= 10.0.0)
- Microsoft.Extensions.Configuration.Json (>= 10.0.0)
- Microsoft.Extensions.Configuration.UserSecrets (>= 10.0.0)
- Microsoft.Extensions.DependencyInjection (>= 10.0.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.0)
- Microsoft.Extensions.DependencyModel (>= 10.0.0)
- Microsoft.Extensions.FileProviders.Physical (>= 10.0.0)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.0)
- Microsoft.Extensions.Localization (>= 10.0.0)
- Microsoft.Extensions.Logging (>= 10.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.0)
- Microsoft.Extensions.Options (>= 10.0.0)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.0)
- Microsoft.Extensions.Options.DataAnnotations (>= 10.0.0)
- Nito.AsyncEx.Context (>= 5.1.2)
- Sparkdo.Core (>= 1.0.1)
- Sparkdo.CrontabQ (>= 1.0.1)
- System.Linq.Dynamic.Core (>= 1.7.0)
- System.Runtime.Loader (>= 4.3.0)
- System.Text.Json (>= 10.0.0)
-
net10.0
- JetBrains.Annotations (>= 2025.2.2)
- Microsoft.Extensions.Configuration (>= 10.0.0)
- Microsoft.Extensions.Configuration.CommandLine (>= 10.0.0)
- Microsoft.Extensions.Configuration.EnvironmentVariables (>= 10.0.0)
- Microsoft.Extensions.Configuration.FileExtensions (>= 10.0.0)
- Microsoft.Extensions.Configuration.Json (>= 10.0.0)
- Microsoft.Extensions.Configuration.UserSecrets (>= 10.0.0)
- Microsoft.Extensions.DependencyInjection (>= 10.0.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.0)
- Microsoft.Extensions.DependencyModel (>= 10.0.0)
- Microsoft.Extensions.FileProviders.Physical (>= 10.0.0)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.0)
- Microsoft.Extensions.Localization (>= 10.0.0)
- Microsoft.Extensions.Logging (>= 10.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.0)
- Microsoft.Extensions.Options (>= 10.0.0)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.0)
- Microsoft.Extensions.Options.DataAnnotations (>= 10.0.0)
- Nito.AsyncEx.Context (>= 5.1.2)
- Sparkdo.Core (>= 1.0.1)
- Sparkdo.CrontabQ (>= 1.0.1)
- System.Linq.Dynamic.Core (>= 1.7.0)
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-preview.1 | 165 | 12/4/2025 |
| 1.0.1 | 2,015 | 11/27/2025 |
| 1.0.0 | 1,934 | 11/25/2025 |
| 1.0.0-preview.5 | 105 | 10/24/2025 |