Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Asp.Net Core Localized Resource in Separate Assembly

Tags:

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?

like image 637
Joshua Belden Avatar asked Feb 04 '17 19:02

Joshua Belden


People also ask

How do you localize in .NET core?

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.

What is Globalisation and Localisation in asp net?

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.


1 Answers

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"].

  • The reason for not adding any 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");

enter image description here

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.

like image 158
Developer Avatar answered Oct 13 '22 00:10

Developer