首页 > 解决方案 > 如何在 ASP.NET MVC 中设置多语言和本地化视图?

问题描述

我已经有一个英语 MVC 网站。现在我需要添加阿拉伯语。为此,我想使用下面的结构来存储我的本地化 .cshtml 文件

英文视图
~/Views/index.cshtml
~/Views/about.cshtml

阿拉伯语视图
~/ar/Views/index.cshtml
~/ar/Views/about.cshtml

英文 URL(它正在工作)
www.samplesite.com/home/index
www.samplesite.com/home/index

阿拉伯语 URL(不起作用)
www.samplesite.com/ar/home/index
www.samplesite.com/ar/home/index

如果 url 带有 /en 或没有语言参数,并且如果 URL 以 /ar 开头,我需要返回英文视图,我需要返回 ar/Views 文件夹中的视图。我应该在路由配置和操作中进行哪些更改才能根据 URL 获得正确的视图?

在此处输入图像描述

标签: c#asp.net-mvcasp.net-mvc-4asp.net-mvc-3

解决方案


为了使用针对不同语言和文化的不同视图本地化 ASP.NET MVC 应用程序,您至少需要执行以下操作:

  1. 将语言代码从 URL 保存到路由数据集合(如果存在)
  2. 根据语言代码设置当前文化(如果存在)
  3. 如果出现语言代码,则将请求路由到本地化视图

1. 保存 URL 中的语言代码以路由数据收集(如果存在)

您需要定义路由映射,以便只要 URL 上有语言代码,就会将其放入路由数据集合中。

您可以在以下位置定义额外的路由映射RouteConfig

namespace DL.SO.Globalization.DotNet.Web.UI
{
    public class RouteConfig
    {
        public static void RegisterRoutes(RouteCollection routes)
        {
            routes.IgnoreRoute("{resource}.axd/{*pathInfo}");

            routes.LowercaseUrls = true;

            routes.MapRoute(
                name: "DefaultWithLang",
                url: "{lang}/{controller}/{action}/{id}",
                defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional },
                constraints: new { lang = new LanguageRouteConstraint() }
            );

            routes.MapRoute(
                name: "Default",
                url: "{controller}/{action}/{id}",
                defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional }
            );
        }
    }
}

我们将回到路由约束,但这里的想法是首先运行这个“DefaultWithLang”映射,看看传入的请求是否附加了语言代码。如果是,则使用 key 将其保存到路由集合中lang。否则,只需正常处理即可。

路线限制

想象一下,我们定义了这 2 个映射,传入的请求看起来像/home/index. 如果没有该路由约束,这将被映射到具有lang“home”的“DefaultWithLang”,这是不正确的。

我们需要一种方法来测试语言代码是否是有效的 2 字母代码。为此,您可以创建路由约束:

using System.Text.RegularExpressions;
using System.Web;
using System.Web.Routing;

namespace DL.SO.Globalization.DotNet.Web.UI.RouteConstraints
{
    public class LanguageRouteConstraint : IRouteConstraint
    {
        public bool Match(HttpContextBase httpContext, Route route, string parameterName, 
            RouteValueDictionary values, RouteDirection routeDirection)
        {
            return Regex.IsMatch((string)values[parameterName], @"^[a-z]{2}$");
        }
    }
}

放置好这个后,请求“/home/index”将首先以“home”作为语言代码进入,但它将失败此路由约束,因为它有超过 2 个字母。这将导致“DefaultWithLang”映射不匹配。然后MVC会继续使用第2个映射,看看这个请求是不是一个合法的请求,就是!


2.根据语言代码设置当前文化,如果存在

现在我们知道语言代码将被放入路由数据集合中。我们可以在此基础上设置当前线程的当前文化和当前 UI 文化。

为此,我们可以创建一个ActionFilter

namespace DL.SO.Globalization.DotNet.Web.UI.Filters
{
    public class LanguageFilter : ActionFilterAttribute
    {
        public override void OnActionExecuting(ActionExecutingContext filterContext)
        {
            var values = filterContext.RouteData.Values;

            string languageCode = (string)values["lang"] ?? "en";

            var cultureInfo = new CultureInfo(languageCode);

            Thread.CurrentThread.CurrentCulture = cultureInfo;
            Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture(cultureInfo.Name);
        }
    }
}

这里我从路由数据集合中读取语言代码值,如果不存在则默认为“en”。

要为整个应用程序启用它,您可以将其添加到FilterConfig.cs

namespace DL.SO.Globalization.DotNet.Web.UI
{
    public class FilterConfig
    {
        public static void RegisterGlobalFilters(GlobalFilterCollection filters)
        {
            filters.Add(new LanguageFilter());
            filters.Add(new HandleErrorAttribute());
        }
    }
}

3. 将请求路由到本地化视图(如果出现语言代码)

与第 2 步类似,现在我们有了语言代码,我们需要创建一个自定义视图引擎来将请求路由到不同的视图:

namespace DL.SO.Globalization.DotNet.Web.UI
{
    public class GlobalizationRazorViewEngine : RazorViewEngine
    {
        protected override IView CreatePartialView(ControllerContext controllerContext, 
            string partialPath)
        {
            partialPath = GetGlobalizeViewPath(controllerContext, partialPath);
            return base.CreatePartialView(controllerContext, partialPath);
        }

        protected override IView CreateView(ControllerContext controllerContext, 
            string viewPath, string masterPath)
        {
            viewPath = GetGlobalizeViewPath(controllerContext, viewPath);
            return base.CreateView(controllerContext, viewPath, masterPath);
        }

        private string GetGlobalizeViewPath(ControllerContext controllerContext, 
            string viewPath)
        {
            var request = controllerContext.HttpContext.Request;
            var values = controllerContext.RouteData.Values;

            string languageCode = (string)values["lang"];
            if (!String.IsNullOrWhiteSpace(languageCode))
            {
                string localizedViewPath = Regex.Replace(viewPath,
                    "^~/Views/",
                    String.Format("~/{0}/Views/", languageCode)
                );

                if (File.Exists(request.MapPath(localizedViewPath)))
                {
                    viewPath = localizedViewPath;
                }
            }

            return viewPath;
        }
    }
}

这里的逻辑应该是直截了当的:如果语言代码存在,请尝试将其附加到 MVC 应用程序将用于查找相应视图的原始视图路径。

注意:您需要将原始文件夹_viewStart.cshtml以及web.config从原始Views文件夹复制到新的本地化Views文件夹。您可以考虑使用不同的文件夹结构来包含所有本地化视图。一种可能的方法是将它们全部放在~/Views文件夹中。

要使用此自定义视图引擎,您需要将其添加到视图引擎集合中Application_Start()

namespace DL.SO.Globalization.DotNet.Web.UI
{
    public class MvcApplication : System.Web.HttpApplication
    {
        protected void Application_Start()
        {
            ViewEngines.Engines.Clear();
            ViewEngines.Engines.Add(new GlobalizationRazorViewEngine());

            AreaRegistration.RegisterAllAreas();
            FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters);
            RouteConfig.RegisterRoutes(RouteTable.Routes);
            BundleConfig.RegisterBundles(BundleTable.Bundles);
        }
    }
}

截图

在此处输入图像描述

zh/网址上:

在此处输入图像描述

文件夹结构:

在此处输入图像描述

Github 源码: https ://github.com/davidliang2008/DL.SO.Globalization.DotNet/tree/master/DL.SO.Globalization.DotNet.Web.UI


推荐阅读