Toolbelt.Blazor.Server.ScopedCulture.Abstractions 1.0.0-preview.1

.NET Standard 2.1
This is a prerelease version of Toolbelt.Blazor.Server.ScopedCulture.Abstractions.
dotnet add package Toolbelt.Blazor.Server.ScopedCulture.Abstractions --version 1.0.0-preview.1
NuGet\Install-Package Toolbelt.Blazor.Server.ScopedCulture.Abstractions -Version 1.0.0-preview.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="Toolbelt.Blazor.Server.ScopedCulture.Abstractions" Version="1.0.0-preview.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Toolbelt.Blazor.Server.ScopedCulture.Abstractions --version 1.0.0-preview.1
#r "nuget: Toolbelt.Blazor.Server.ScopedCulture.Abstractions, 1.0.0-preview.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.
// Install Toolbelt.Blazor.Server.ScopedCulture.Abstractions as a Cake Addin
#addin nuget:?package=Toolbelt.Blazor.Server.ScopedCulture.Abstractions&version=1.0.0-preview.1&prerelease

// Install Toolbelt.Blazor.Server.ScopedCulture.Abstractions as a Cake Tool
#tool nuget:?package=Toolbelt.Blazor.Server.ScopedCulture.Abstractions&version=1.0.0-preview.1&prerelease

Blazor Server Scoped Culture NuGet Package

"It's a very dirty hack, but it works for now."


This is a library for Blazor Server apps adding an ability that changes the current culture of each connection without reloading.


Quick Start


  1. Add the "Toolbelt.Blazor.Server.ScopedCulture" NuGet package to your Blazor server application project.
dotnet add package Toolbelt.Blazor.Server.ScopedCulture --prerelease
  1. Register the "Scoped Culture" service into DI container in your app.
// Program.cs
using Toolbelt.Blazor.Extensions.DependencyInjection; // 👈 Open this namespace, and...
builder.Services.AddScopedCulture(); // 👈 Add this line.
  1. To be convinience, open the "Toolbelt.Blazor.Server.ScopedCulture" name space globally.
@* _Import.razor *@
@* 👇 Open this name space. *@
@using Toolbelt.Blazor.Server.ScopedCulture
  1. Surround the entire contents in App.razor with the <ScopedCultureZone> component tag.
@* App.razor *@
  <Router AppAssembly="@typeof(Program).Assembly">


When you want to change the current culture & current UI culture, don't set the culture values you want to change to CultureInfo.CurrentCulture and CultureInfo.CurrentUICulture static properties directly because it doesn't cause any effect.

Instead, now you can call the SetCurrentCulture() method of the IScopedCulture service anytime with the culture name you want to change.

The SignalR connection and application states will be kept.

@* *.razor *@
@* 👇 Inject the IScopedCulture service into your Razor components. *@
@inject IScopedCulture ScopedCulture
@code {
  // 👇 Call "SetCurrentCulture()" method with the culture name such as "en", "sv", "ja", etc.

Track to changes in current culture

Suppose you need to track changing current culture in the current connection on Blazor server apps, particularly re-rendering components after changed culture.

In that case, you can do that by one of the following three methods.

Method A. Surround contents by the ScopedCultureZone component

When you change the current culture in the current connection on Blazor Server apps, a ScopedCultureZone component's StateHasChanged() method will be invoked.

Then, that will cause re-rendering of the child content inside a ScopedCultureZone component.

@* *.razor *@
  This area will be re-rendered every time you change the current 
  culture by using the "ScopedCulture.SetCurrentCulture()".
Method B. Register componets to re-render by the RefreshWhenCultureChanged() method

Once you invoke the IScopedCulture.RefreshWhenCultureChanged() method with your component as an argument, that component's StateHasChanged() method will be invoked every time you change the current culture in the current connection on Blazor Server apps.

@* *.razor *@
@inject IScopedCulture ScopedCulture
  public override void OnInitialized() 
    // 👇 After doing this, the "StateHasChanged()" method of this component
    //    will be invoked every time you change the current culture
    //    by using the "IScopedCulture.SetCurrentCulture()".
Method C. Handle the IScopedCulture.CurrentCultureChanged event
@* *.razor *@
@* 👇 Please remember to implement IDisposable interface. *@
@implements IDisposable
@inject IScopedCulture ScopedCulture
  public override void OnInitialized() 
    // 👇 Handle the `IScopedCulture.CurrentCultureChanged` event.
    this.ScopedCulture.CurrentCultureChanged += this.ScopedCulture_CurrentCultureChanged;

  private void ScopedCulture_CurrentCultureChanged(object sender, EventArgs e) {
    // 👉 This method will be invoked every time you change 
    // the current culture by using the "IScopedCulture.SetCurrentCulture()".

  public void Dispose() {
    // 👇 Please remember to detach the event handler.
    this.ScopedCulture.CurrentCultureChanged -= this.ScopedCulture_CurrentCultureChanged;

Supported versions

Blazor Server apps on .NET Core 3.1 or later (including .NET 5.0, 6.0, 7.0) are supported.


Please remember that this library access and overwrite non-public API of the Blazor Server's infrastructure.

That means there is a risk that this library might cause your apps to be crashed unexpectedly in the current and future versions of .NET.

Release notes

The release notes is here.


MIT License

Product 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-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen 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)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Toolbelt.Blazor.Server.ScopedCulture.Abstractions:

Package Downloads

This NuGet package for Blazor Server apps adding an ability that changes the current culture of each connection without reloading.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.0-preview.1 616 4/29/2022

- Initial release.