I am trying to use the new Localization features of .NET Core, but outside the simple sample Microsoft has provided here, https://docs.microsoft.com/en-us/aspnet/core/fundamentals/localization#resource-file-naming.
I have my Controllers in a separate project, ProjectA.Controllers, while I have a shared resource class in a common project, ProjectB.Localization. I've configured my startup class as prescribed in the docs.
I am unclear on what to name my resource file and where exactly to put it. I've configured the option to store in the directory "Resources". Is that in the Web project or my ProjectB.Localization where my SharedResource class is? The docs say that if it's a separate assembly, the full namespace should be used. So I've named it, "WorldCart.Facilities.Localization.SharedResource.es.resx" and placed it in the resources folder of the website.
When I run the web app, and debug in the home controller, I do not get a translated string, I get the english version.
Any ideas?
Now to apply localizationlocalizationInternationalization is the process of designing a software application so that it can be adapted to various languages and regions without engineering changes. Localization is the process of adapting internationalized software for a specific region or language by translating text and adding locale-specific components.https://en.wikipedia.org › Internationalization_and_localizationInternationalization and localization - Wikipedia to an ASP.NET Core Web API project, there are three major steps to follow: Including the localization into the API project middleware. Adding the needed localization resource file. Using the IStringLocalizer to access the resource file.
Globalization is the process of designing the application in such a way that it can be used by users from across the globe (multiple cultures). Localization, on the other hand, is the process of customization to make our application behave as per the current culture and locale.
Very late answer, but it might help someone... I had a similar situation where I had to have the resource files in separate common assembly instead of having it inside the mail web/api project (Core 2.1). The reason being, I could be using the localized resources from other assemblies like Business or DAL layer for throwing warning/error/information messages. This is what I did:
Assume that my web project namespace is MyApp.Web
and my resources are in separate class lib MyApp.Resources
. In the resources library, create a folder (optional), say "Messages", and create a class Messages.cs
. Create the resource files inside the same folder adhering to the naming conventions. For example, Messages.fr.resx
.
In the ConfigureServices
method of the main project, add the localization without any resource path*:
services.AddLocalization(); services.Configure<RequestLocalizationOptions>( opts => { /* your configurations*/ var supportedCultures = new List<CultureInfo> { new CultureInfo("en"), new CultureInfo("fr") }; opts.DefaultRequestCulture = new RequestCulture("en", "en"); // Formatting numbers, dates, etc. opts.SupportedCultures = supportedCultures; // UI strings that we have localized. opts.SupportedUICultures = supportedCultures; });
And in the Configure
method, add app.UseRequestLocalization();
In your controller, inject IStringLocalizer<Messages> localizer
, where Messages
is the class you created in the Resources library. All your localized resources will be available in the localizer
object, i.e., localizer["your key or default text"]
.
ResourcePath
in the services.AddLocalization();
options is due to the reason that both the resource files (Messages.fr.resx
) and the dummy class (Messages.cs
) are in the same path. The framework will check for the resource file relative to the class which we have specified in IStringLocalizer<>
. If the Messages.cs
was in the root folder of MyApp.Resources
lib and the resource files were inside folder "xyz", then the configuration should be services.AddLocalization(ops => ops.ResourcesPath = "xyz");
UPDATE - Responding to the queries in the comments:
MVC Views In MVC Views, the documented approach uses IViewLocalizer
, but does not support resource sharing. So you can inject IStringLocalizer<>
in the view for using the shared resources. For example:
@inject IStringLocalizer<Messages> localizer <h2>Information - @localizer["Shared resource access in MVC Views"]</h2>
Data Annotations In order to use shared resources in the data annotations, you can use the factory method in the service:
services.AddMvc() .SetCompatibilityVersion(CompatibilityVersion.Version_2_1) .AddDataAnnotationsLocalization(options => { options.DataAnnotationLocalizerProvider = (type, factory) => factory.Create(typeof(Messages)); });
where the Messages
in the typeof(Messages)
is your shared resource dummy class.
If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!
Donate Us With