Sparkdo.Localization.Abstractions
1.0.2
dotnet add package Sparkdo.Localization.Abstractions --version 1.0.2
NuGet\Install-Package Sparkdo.Localization.Abstractions -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.Localization.Abstractions" Version="1.0.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Sparkdo.Localization.Abstractions" Version="1.0.2" />
<PackageReference Include="Sparkdo.Localization.Abstractions" />
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.Localization.Abstractions --version 1.0.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Sparkdo.Localization.Abstractions, 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.Localization.Abstractions@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.Localization.Abstractions&version=1.0.2
#tool nuget:?package=Sparkdo.Localization.Abstractions&version=1.0.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Sparkdo.Localization.Abstractions
Sparkdo 本地化抽象模块，提供本地化功能的抽象接口和基础实现。
功能特性
- 本地化字符串抽象接口
- 本地化资源管理
- 多语言支持
- 与 Sparkdo 框架无缝集成
安装
<PackageReference Include="Sparkdo.Localization.Abstractions" Version="x.x.x" />
核心组件
本地化接口
ILocalizableString: 本地化字符串接口IAsyncLocalizableString: 异步本地化字符串接口IWithNameWithLocalizableDisplayName: 具有本地化显示名称的接口
本地化实现
LocalizableString: 本地化字符串实现FixedLocalizableString: 固定本地化字符串实现
本地化工厂
ISparkdoStringLocalizerFactory: Sparkdo字符串本地化工厂接口
常量和属性
CultureContansts: 文化常量LocalizationResourceNameAttribute: 本地化资源名称特性
使用方法
基本本地化
// 创建本地化字符串
var localizableString = new LocalizableString<MyResource>("PropertyName");
// 本地化字符串
var localized = localizableString.Localize(stringLocalizerFactory);
固定字符串本地化
// 创建固定本地化字符串
var fixedString = "Hello World".ToFixedLocalizableString();
// 本地化固定字符串
var localized = fixedString.Localize(stringLocalizerFactory);
使用本地化工厂
// 创建本地化器
var localizer = stringLocalizerFactory.CreateByResourceName("MyResource");
// 异步创建本地化器
var localizer = await stringLocalizerFactory.CreateByResourceNameAsync("MyResource");
扩展性
该库提供了完整的本地化抽象功能实现，可以通过以下方式扩展：
- 实现自定义的
ILocalizableString来提供特定的本地化逻辑 - 实现自定义的
ISparkdoStringLocalizerFactory来提供特定的本地化器创建逻辑 - 实现自定义的本地化资源管理逻辑
代码结构说明
本项目包含以下主要组件：
本地化核心接口
ILocalizableString: 本地化字符串接口，定义本地化字符串的基本方法IAsyncLocalizableString: 异步本地化字符串接口，定义异步本地化字符串的方法IWithNameWithLocalizableDisplayName: 具有本地化显示名称的接口
本地化核心实现
LocalizableString: 本地化字符串实现，支持同步和异步本地化FixedLocalizableString: 固定本地化字符串实现，用于固定值的本地化
本地化工厂接口
ISparkdoStringLocalizerFactory: Sparkdo字符串本地化工厂接口，定义创建本地化器的方法
扩展方法
SparkdoStringLocalizerFactoryExtensions: 本地化工厂扩展方法FixedLocalizableStringExtensions: 固定本地化字符串扩展方法HasNameWithLocalizableDisplayNameExtensions: 具有本地化显示名称对象的扩展方法
常量和属性
CultureContansts: 定义标准文化标识符LocalizationResourceNameAttribute: 用于指定类型的本地化资源名称
所有公共接口和类都添加了详细的 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)
- System.Linq.Dynamic.Core (>= 1.7.1)
NuGet packages (4)
Showing the top 4 NuGet packages that depend on Sparkdo.Localization.Abstractions:
| Package | Downloads |
|---|---|
|
Sparkdo.Localization
Sparkdo 本地化模块，提供完整的本地化功能实现 |
|
|
Sparkdo.Settings
Sparkdo 设置管理库，提供设置定义、设置值提供者、设置存储等设置管理功能 |
|
|
Sparkdo.ObjectExtending
Sparkdo 对象扩展模块，提供对象属性扩展功能 |
|
|
Sparkdo.TextTemplating.Abstractions
Sparkdo 框架的文本模板抽象实现。提供文本模板功能的核心接口和基础类实现，支持多种模板引擎扩展。 |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 1.0.2 | 741 | 4/27/2026 |
| 1.0.2-preview.5 | 152 | 4/15/2026 |
| 1.0.2-preview.4 | 158 | 2/8/2026 |
| 1.0.2-preview.3 | 170 | 2/1/2026 |
| 1.0.2-preview.2 | 180 | 1/31/2026 |
| 1.0.2-preview.1 | 224 | 12/4/2025 |
| 1.0.1 | 2,892 | 11/27/2025 |
| 1.0.0 | 2,827 | 11/25/2025 |
| 1.0.0-preview.5 | 142 | 10/24/2025 |