我可以在不是控制器的类中使用 IStringLocalizer

Question

我了解如何在派生自 Controller 的类中使用 IStringLocalizer 接口，例如此处或此处所述。

在不是从控制器派生的类中使用 IStringLocalizer 的正确方法是什么？

我找不到任何解决这个问题的例子。

是否总是需要将 IStringLocalizer 或 IStringLocalizerFactory 传递给构造函数？

笔记。
我知道这是一个相当笼统的问题（堆栈溢出是针对具体的编程问题）。背景是我为 .NET 项目制作了一个本地化工具。我试图弄清楚我的工具必须对源代码进行哪些更改以支持 ASP.NET Core 项目中的本地化。

Answer 1

一个类是否从 Controller 派生并不重要。

重要的是您的对象是由依赖注入容器创建的，而不是使用 new 运算符创建的，如here所述。如果要在所有类中使用 ASP.NET Core 本地化机制，则必须采用此模式来创建对象。

这个页面很好地描述了如何创建对象，但我将尝试举一个例子来说明它如何与本地化一起工作。

我创建了一个类 MyHelper。该类期望将本地化器对象传递给构造函数。它包含一个属性 Hello，它返回一个本地化的字符串。

namespace AddingLocalization.Classes
{
  public class MyHelper
  {
    private readonly IStringLocalizer<MyHelper> _localizer;

    public MyHelper(IStringLocalizer<MyHelper> localizer)
    {
      _localizer = localizer;
    }

    public string Hello
    {
      get
      {
        return _localizer["Hello World."];
      }
    }

  }
}

在 Startup 类的 ConfigureServices 方法中，我添加了此处描述的样板代码，并添加了一行以将类 MyHelper 注册到依赖注入容器。

public void ConfigureServices(IServiceCollection services)
{
  services.AddLocalization(opts => opts.ResourcesPath = "Resources");

  services.AddMvc()
          .AddViewLocalization (
               LanguageViewLocationExpanderFormat.Suffix,
               opts => opts.ResourcesPath = "Resources" )
          .AddDataAnnotationsLocalization();

  // This line registers the class MyHelper with the 
  // Dependency Injection Container.      
  services.AddTransient<MyHelper>();
}

在我的控制器类中，我向构造函数添加了一个 MyHelper 类型的参数，该参数存储在一个成员变量中。

public class HomeController : Controller
{
  private readonly IStringLocalizer<HomeController> _localizer ;
  private readonly MyHelper                         _h ;

  public HomeController ( IStringLocalizer<HomeController> localizer,
                          MyHelper                         h )
  {
    _localizer = localizer;
    _h         = h ;
  }

  ...

  public IActionResult About()
  {
    ViewData["Message"] = _h.Hello ;
    return View();
  }

  ...
}  

因为 MyHelper 类已经注册到依赖注入容器中，所以它会创建这个对象并自动将它传递给构造函数。这就是依赖注入容器的神奇之处。

在 About() 方法中，我从 MyHelper 对象中获取属性。

代码就是这样，但我想确定它实际上会从资源文件中读取字符串。

这里描述了资源文件的命名约定：

它基于类的全名，没有程序集的名称。在我的例子中，类称为AddingLocalization.Classes.MyHelper，程序集称为AddingLocalization，因此相关名称为Classes.MyHelper。

实际上有两种命名约定，使用点或子目录，因此我们可以将资源文件称为其中之一

• Classes.MyHelper.resx
• 类\MyHelper.resx

ConfigureServices 中的样板代码指定了 ResourcesPath“Resources”，因此我们必须在此处放置资源文件。我选择了第二个命名选项，所以我的资源文件是

• 资源\类\MyHelper.resx

正如您在解决方案资源管理器中看到的那样

我们不需要 Visual Studio 创建文件 MyHelper.Designer.cs 来访问资源，因此我们应该清除资源文件的 CustomTool 属性。

这很重要，因为如果我们不禁用自定义工具，这些名称将不是有效的资源名称，并且可能会生成错误消息。

（以前的本地化方法（来自 Microsoft）总是使用伪造的资源名称（例如，使用下划线而不是空格）来访问资源。新的 ASP.NET 核心本地化使用原始字符串作为资源名称。）

最后我定义了一个资源字符串，如下所示：

我实际上还没有尝试以不同的语言访问资源（还没有），但是 localizer 对象确实正确读取了资源。