Sparkdo.ExceptionHandling
1.0.3
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.ExceptionHandling --version 1.0.3
NuGet\Install-Package Sparkdo.ExceptionHandling -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.ExceptionHandling" Version="1.0.3" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Sparkdo.ExceptionHandling" Version="1.0.3" />
<PackageReference Include="Sparkdo.ExceptionHandling" />
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.ExceptionHandling --version 1.0.3
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Sparkdo.ExceptionHandling, 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.ExceptionHandling@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.ExceptionHandling&version=1.0.3
#tool nuget:?package=Sparkdo.ExceptionHandling&version=1.0.3
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Sparkdo.ExceptionHandling
Sparkdo 异常处理库，提供统一的异常处理机制和错误信息转换功能。
功能特性
- 统一异常通知机制
- 异常到错误信息的转换
- 本地化异常消息支持
- 与 ASP.NET Core 集成
- 支持自定义异常订阅者
- 敏感信息控制
安装
<PackageReference Include="Sparkdo.ExceptionHandling" Version="x.x.x" />
核心组件
DefaultExceptionToErrorInfoConverter
默认异常到错误信息转换器，负责将异常对象转换为标准化的错误信息：
- 支持敏感信息控制
- 本地化错误消息
- 处理各种特定异常类型
- 可扩展的转换逻辑
SparkdoExceptionHandlingModule
异常处理模块，负责配置异常处理相关服务：
- 注册异常转换器
- 配置本地化资源
- 集成虚拟文件系统
IExceptionNotifier & DefaultExceptionNotifier
异常通知器接口及默认实现，提供异常通知机制：
- 支持异常订阅者模式
- 可扩展的订阅者机制
- 统一的异常通知流程
扩展性
该库提供了完整的异常处理功能实现，可以通过以下方式扩展：
- 实现自定义的
IExceptionSubscriber来添加特定的异常处理逻辑 - 实现自定义的
IExceptionToErrorInfoConverter来添加特定的异常转换逻辑 - 通过配置
ExceptionHandlingOptions来自定义异常处理行为
代码结构说明
本项目包含以下主要组件：
异常转换器
IExceptionToErrorInfoConverter: 异常到错误信息转换器接口DefaultExceptionToErrorInfoConverter: 默认异常到错误信息转换器实现
异常通知器
IExceptionNotifier: 异常通知器接口DefaultExceptionNotifier: 默认异常通知器实现NullExceptionNotifier: 空异常通知器实现
异常订阅者
IExceptionSubscriber: 异常订阅者接口ExceptionSubscriber: 异常订阅者抽象基类
配置
SparkdoExceptionHandlingOptions: 异常处理配置选项SparkdoExceptionHandlingModule: 异常处理模块配置
资源
SparkdoExceptionHandlingResource: 异常处理资源- 本地化资源文件
所有公共接口和类都添加了详细的 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.8)
- Microsoft.Extensions.Configuration.CommandLine (>= 10.0.8)
- Microsoft.Extensions.Configuration.EnvironmentVariables (>= 10.0.8)
- Microsoft.Extensions.Configuration.FileExtensions (>= 10.0.8)
- Microsoft.Extensions.Configuration.Json (>= 10.0.8)
- Microsoft.Extensions.Configuration.UserSecrets (>= 10.0.8)
- Microsoft.Extensions.DependencyInjection (>= 10.0.8)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.8)
- Microsoft.Extensions.DependencyModel (>= 10.0.8)
- Microsoft.Extensions.FileProviders.Composite (>= 10.0.8)
- Microsoft.Extensions.FileProviders.Embedded (>= 10.0.8)
- Microsoft.Extensions.FileProviders.Physical (>= 10.0.8)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.8)
- Microsoft.Extensions.Localization (>= 10.0.8)
- Microsoft.Extensions.Logging (>= 10.0.8)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.8)
- Microsoft.Extensions.Options (>= 10.0.8)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.8)
- Microsoft.Extensions.Options.DataAnnotations (>= 10.0.8)
- Microsoft.Extensions.Primitives (>= 10.0.8)
- Nito.AsyncEx.Context (>= 5.1.2)
- Sparkdo.Localization (>= 1.0.3)
- Sparkdo.Security (>= 1.0.3)
- Sparkdo.Validation.Abstractions (>= 1.0.3)
- System.Linq.Dynamic.Core (>= 1.7.2)
NuGet packages (5)
Showing the top 5 NuGet packages that depend on Sparkdo.ExceptionHandling:
| Package | Downloads |
|---|---|
|
Sparkdo.Ddd.Domain
Sparkdo DDD 领域模型库，提供领域驱动设计的核心组件实现 |
|
|
Sparkdo.AspNetCore
Sparkdo ASP.NET Core 集成库，提供与 ASP.NET Core 框架深度集成的功能实现 |
|
|
Sparkdo.UI
library for the Sparkdo framework |
|
|
Sparkdo.ExceptionHandling.Mediation
Sparkdo Mediation 的异常分发中间件与 Manifest 自动接线。 |
|
|
Sparkdo.ExceptionHandling.Domain
Sparkdo DomainException 到 ExceptionHandling 的可选元数据适配。 |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 2.0.0-preview.2 | 46 | 7/20/2026 |
| 1.0.4-preview.3 | 189 | 6/8/2026 |
| 1.0.4-preview.2 | 193 | 6/7/2026 |
| 1.0.4-preview.1 | 179 | 6/7/2026 |
| 1.0.3 | 434 | 6/6/2026 |
| 1.0.3-preview.1 | 195 | 5/17/2026 |
| 1.0.2 | 347 | 4/27/2026 |
| 1.0.2-preview.5 | 100 | 4/15/2026 |
| 1.0.2-preview.4 | 112 | 2/8/2026 |
| 1.0.2-preview.3 | 107 | 2/1/2026 |
| 1.0.2-preview.2 | 131 | 1/31/2026 |
| 1.0.2-preview.1 | 213 | 12/4/2025 |
| 1.0.1 | 924 | 11/27/2025 |
| 1.0.0 | 884 | 11/25/2025 |
| 1.0.0-preview.5 | 146 | 10/24/2025 |