JCTools.I18N 2.0.0.2

.NET Core 1.1
NuGet\Install-Package JCTools.I18N -Version 2.0.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.
dotnet add package JCTools.I18N --version 2.0.0.2
<PackageReference Include="JCTools.I18N" Version="2.0.0.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add JCTools.I18N --version 2.0.0.2
#r "nuget: JCTools.I18N, 2.0.0.2"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install JCTools.I18N as a Cake Addin
#addin nuget:?package=JCTools.I18N&version=2.0.0.2

// Install JCTools.I18N as a Cake Tool
#tool nuget:?package=JCTools.I18N&version=2.0.0.2

JCTools.I18N

A simplification of the configuration of location in .net core

Installation

PM> Install-Package JCTools.I18N

Usage

For configure the localization and globalization settings follow the next steps:

  1. Add the nuget package
PM> Install-Package JCTools.I18N
  1. Add a new private field at the Startup class
private readonly IHostingEnvironment _enviroment;
  1. Set the value of the created field in the last step, with the value of the constructor argument
public Startup(IHostingEnvironment env)
{
    // Store the enviroment instance
    _enviroment = env;
    ...
}
  1. Create a new empty class. The application will use this class how reference to the unique resources file. (You can use the Startup class)
  2. Create a new folder for stored the resource files, and add a new resource file named equals that the class of the previous step, this resource file not should have the culture postfix. This file will use for get the localized strings for the default culture. This file should have your access modifier setted to Public.
  3. Create the necessary resource files for stored the localized strings of the rest of supported cultures. This files should have your access modifier setted to public.
  4. Add the next lines to the startup class in the ConfugureServices method:
public void ConfigureServices(IServiceCollection services)
{
    ...
    services.AddMvc();

    services.AddLocalizationServices(
        // The supported cultures
        new List<CultureInfo>
            {
                new CultureInfo("en"),
                new CultureInfo("en-US"),
                new CultureInfo("es"),
                new CultureInfo("es-MX")
            },
        // the default culture
        defaultCulture: "es-MX"
    )
    .AddSingleLocalizationFile<I18N, Resources.I18N>(_enviroment);
}
  1. Add the next line in the method Configure of the Startup class:
app.UseLocalization();

   The previous line should will be add before the next code:

app.UseStaticFiles();

app.UseMvc(routes =>
{
	routes.MapRoute(
		name: "default",
		template: "{controller=Home}/{action=Index}/{id?}");
});

For access at the localized strings into the Controllers, use:

  1. Add a private field for stored the localizer instance
private readonly SingleLocalizer _localizer;
  1. Add at the constructor of your controller an argument for receive the localizer instance through dependency injection and set the value of the created field in the previous step
public HomeController(SingleLocalizer localizer)
        {
            ...
            // store the receive argument into our field
            _localizer = localizer;
            ...
        }
  1. Use the field as shown below:
ViewData["Message"] = _localizer["About_Message"];

For access at the localized string into the views, use:

  1. Add at your _ViewImports.cshtml file the next dependency, it allows access in all views at the Localizer instance:
@inject JCTools.I18N.Services.SingleHtmlLocalizer Localizer
  1. Use the Localize instance as shown below:
<strong>@Localizer["Support"]:</strong> <a href="mailto:Support@example.com">Support@example.com</a>

For access to the localized strings into the models and viewmodels, use the data annotation of the namespace System.ComponentModel.DataAnnotations, how to shown below

using System.ComponentModel.DataAnnotations;

namespace JCTools.I18N.Test.ViewModels
{
    public class ContactViewModel
    {
        [Display(Name = "ContactViewModel_Email", ResourceType = typeof(Resources.I18N))]
        [EmailAddress(ErrorMessageResourceName = "ContactViewModel_EmailError", ErrorMessageResourceType = typeof(Resources.I18N))]
        public string Email { get; set; }
        [Display(Name = "ContactViewModel_Message", ResourceType = typeof(Resources.I18N))]
        public string Message { get; set; }
    }
}

For view spanish usage process, visit: JCTools.mx

License

MIT License

Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows
.NET Core netcoreapp1.1 netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.0.0.2 1,237 10/26/2017
1.0.0.5 1,206 6/30/2017