JLocalizer 1.1.1
dotnet add package JLocalizer --version 1.1.1
NuGet\Install-Package JLocalizer -Version 1.1.1
<PackageReference Include="JLocalizer" Version="1.1.1" />
<PackageVersion Include="JLocalizer" Version="1.1.1" />
<PackageReference Include="JLocalizer" />
paket add JLocalizer --version 1.1.1
#r "nuget: JLocalizer, 1.1.1"
#:package JLocalizer@1.1.1
#addin nuget:?package=JLocalizer&version=1.1.1
#tool nuget:?package=JLocalizer&version=1.1.1
JLocalizer
JLocalizer is a JSON-backed localization package for Microsoft.Extensions.Localization.
It lets ASP.NET Core and worker-service applications use embedded JSON resources through the familiar IStringLocalizer and IStringLocalizer<T> APIs.
Supported frameworks
netstandard2.0.NET 8.NET 9.NET 10
Install
dotnet add package JLocalizer
Quick start
Create a marker resource type:
using JLocalizer;
namespace MyApp.Localization;
[JLocalizer("Localization")]
public sealed class AppResources
{
}
Add embedded JSON resources to your project:
<ItemGroup>
<EmbeddedResource Include="Localization\en-US.json" />
<EmbeddedResource Include="Localization\es-ES.json" />
</ItemGroup>
Register JLocalizer:
using JLocalizer;
builder.Services.AddJLocalizer(localizer =>
{
localizer.DefaultCulture("en-US");
localizer.AddLocalizedResource<AppResources>();
});
Inject and use the localizer:
public sealed class GreetingService
{
private readonly IStringLocalizer<AppResources> _localizer;
public GreetingService(IStringLocalizer<AppResources> localizer)
{
_localizer = localizer;
}
public string GetGreeting(string name)
{
return _localizer["HelloUser", name];
}
}
Example en-US.json:
{
"HelloUser": "Hello, {0}!"
}
Resource fallback
JLocalizer resolves strings in this order:
- Current UI culture, for example
en-IN. - Parent cultures, for example
en. - Configured default culture.
- The key itself when no value is found.
Reload resources
Use Reset() when a custom binder reads from a mutable source and the localization store should be rebuilt:
localizer.Reset();
| 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 is compatible. 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 is compatible. 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. |
-
.NETStandard 2.0
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Localization.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Options (>= 8.0.0)
- Newtonsoft.Json (>= 13.0.3)
-
net10.0
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Localization.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Options (>= 8.0.0)
- Newtonsoft.Json (>= 13.0.3)
-
net8.0
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Localization.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Options (>= 8.0.0)
- Newtonsoft.Json (>= 13.0.3)
-
net9.0
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Localization.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Options (>= 8.0.0)
- Newtonsoft.Json (>= 13.0.3)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.