设置语种
新增语种
数据库操作
打开多语言表AbpLanguages，添加一条记录．
程序操作
在基础设施层(即JD.CRS.EntityFrameworkCore)的\EntityFrameworkCore\Seed\Host\下打开DefaultLanguagesCreator.cs //用以存放多语言相关信息
添加一行代码．
new ApplicationLanguage(tenantId, "zh-Hant", "繁體中文", "famfamfam-flags hk"), //增加繁体中文
private static List<ApplicationLanguage> GetInitialLanguages()
{
var tenantId = CRSConsts.MultiTenancyEnabled ? null : (int?)MultiTenancyConsts.DefaultTenantId;
return new List<ApplicationLanguage>
{
new ApplicationLanguage(tenantId, "en", "English", "famfamfam-flags gb"),
new ApplicationLanguage(tenantId, "ar", "العربية", "famfamfam-flags sa"),
new ApplicationLanguage(tenantId, "de", "German", "famfamfam-flags de"),
new ApplicationLanguage(tenantId, "it", "Italiano", "famfamfam-flags it"),
new ApplicationLanguage(tenantId, "fr", "Français", "famfamfam-flags fr"),
new ApplicationLanguage(tenantId, "pt-BR", "Português", "famfamfam-flags br"),
new ApplicationLanguage(tenantId, "tr", "Türkçe", "famfamfam-flags tr"),
new ApplicationLanguage(tenantId, "ru", "Русский", "famfamfam-flags ru"),
new ApplicationLanguage(tenantId, "zh-Hans", "简体中文", "famfamfam-flags cn"),
new ApplicationLanguage(tenantId, "zh-Hant", "繁體中文", "famfamfam-flags hk"),
new ApplicationLanguage(tenantId, "es-MX", "Español México", "famfamfam-flags mx"),
new ApplicationLanguage(tenantId, "nl", "Nederlands", "famfamfam-flags nl"),
new ApplicationLanguage(tenantId, "ja", "日本語", "famfamfam-flags jp")
};
}
删除语种
打开多语言表AbpLanguages，删除一条记录．
设置默认语种
打开默认设置表AbpSettings，更新一条记录．
Abp.Localization.DefaultLanguageName从en(即英文)修改为zh-Hans(即简体中文)．
设置资源
新增资源文件
在领域层(即JD.CRS.Core)的\Localization\SourceFiles\
新增资源文件CRS-zh-hk.xml //用以存放繁体中文资源
<?xml version="1.0" encoding="utf-8" ?>
<localizationDictionary culture="zh-Hant">
<texts>
<text name="AppName" >排班系統</text>
<text name="CRS" value="排班系統" />
<text name="StartTyping">開始輸入</text>
<text name="Version">版本</text>
<text name="CopyRight" >© 2019 排班系統</text>
<text name="HomePage" value="主頁" />
<text name="Data">基礎資料</text>
<text name="Service">綜合服務</text>
<text name="Report">管理報表</text>
<text name="Setting">系統設置</text>
<text name="Office">辦公室資訊</text>
<text name="Department">院系</text>
<text name="Course">課程</text>
<text name="Instructor">教職員</text>
<text name="Student">學生</text>
<text name="OfficeInstructor">教職員辦公室分配</text>
<text name="DepartmentInstructor">院系主任設置</text>
<text name="DepartmentCourse">院系課程設置</text>
<text name="InstructorCourse">教職員課程分配</text>
<text name="StudentCourse">學生選課</text>
<text name="OfficeReport">辦公室報表</text>
<text name="DepartmentReport">院系報表</text>
<text name="CourseReport">課程報表</text>
<text name="InstructorReport">教職員報表</text>
<text name="StudentReport">學生報表</text>
<text name="About" value="關於" />
<text name="Skins">皮膚</text>
<text name="Settings">設置</text>
<text name="WelcomeMessage" value="歡迎使用 CRS!" />
<text name="FormIsNotValidMessage" value="部分輸入資訊不符合要求，請檢查並改正.." />
<text name="TenantNameCanNotBeEmpty" value="租戶名不能為空" />
<text name="InvalidUserNameOrPassword" value="用戶名或密碼無效" />
<text name="ThereIsNoTenantDefinedWithName{0}" value="租戶 {0}不存在" />
<text name="TenantIsNotActive" value="租戶 {0} 未啟動." />
<text name="UserIsNotActiveAndCanNotLogin" value="用戶 {0} 未啟動，不能登錄." />
<text name="PleaseEnterLoginInformation" value="請輸入登錄資訊" />
<text name="TenancyName" value="租戶標識" />
<text name="UserNameOrEmail" value="用戶名或郵箱地址" />
<text name="Password" value="密碼" />
<text name="RememberMe" value="記住我" />
<text name="ForgetPassword" value="忘記密碼"/>
<text name="NotSelected" value="未選"/>
<text name="ChangeTenant" value="更改租戶"/>
<text name="LeaveEmptyToSwitchToHost" value="留空以切換到Host"/>
<text name="LogIn" value="登錄" />
<text name="LoginFailed" value="登錄失敗!" />
<text name="UserNamePlaceholder" >請輸入帳戶</text>
<text name="PasswordPlaceholder" >請輸入密碼</text>
<text name="LoginPrompt" >正在登陸，請稍候！</text>
<text name="UserProfile" >使用者資料</text>
<text name="Users" >用戶</text>
<text name="Roles" >角色</text>
<text name="Tenants" >租戶</text>
<text name="Logout" >註銷</text>
<text name="ManageMenu" >菜單</text>
<text name="LabelOptions" >頁簽操作</text>
<text name="ClearAll" >關閉所有</text>
<text name="ClearOthers" >關閉其他</text>
<text name="Create" >創建</text>
<text name="Add" >添加</text>
<text name="Edit" >編輯</text>
<text name="Delete">刪除</text>
<text name="Find" >查找</text>
<text name="CreationTime">創建時間</text>
<text name="Actions">操作</text>
<text name="Keyword">關鍵字</text>
<text name="NoDatas">沒有結果</text>
<text name="Select">請選擇</text>
<text name="SelectDate">請選擇</text>
<text name="Tips">提示</text>
<text name="DeleteConfirm">確定刪除？</text>
<text name="Title" >標題</text>
<text name="Content" >內容</text>
<text name="ChangePassword" >修改密碼</text>
<text name="PasswordComplexityNotSatisfied">密碼複雜度要求不符.</text>
<text name="PasswordRequireDigit">密碼至少需要一位元是0到9的數位.</text>
<text name="PasswordRequireLowercase">密碼至少需要一位元是a到z的小寫字母.</text>
<text name="PasswordRequireNonAlphanumeric">密碼至少需要包含一個特殊字元（非字母或數位的字元）.</text>
<text name="PasswordRequireUppercase">密碼至少需要一位元是A到Z的大寫字母.</text>
<text name="PasswordTooShort">密碼長度太短</text>
<text name="UserName">用戶名</text>
<text name="Name">名稱</text>
<text name="IsActive">是否啟用</text>
<text name="LastLoginTime">最近登陸時間</text>
<text name="RoleName">角色名</text>
<text name="DisplayName">顯示名</text>
<text name="Description">描述</text>
<text name="IsStatic">是否內置</text> <text name="All">全部</text>
<text name="Actived">啟用</text>
<text name="NoActive">未啟用</text> <text name="Yes">是</text>
<text name="No">否</text> <text name="Cancel">取消</text>
<text name="OK">確定</text>
<text name="CreateNewRole">創建新角色</text>
<text name="RoleDetails">角色詳情</text>
<text name="RolePermission">角色許可權</text>
<text name="EditRole">編輯角色</text>
<text name="DeleteRolesConfirm">確認刪除該角色？</text> <text name="CreateNewUser">創建新用戶</text>
<text name="UserDetails">用戶詳情</text>
<text name="UserRoles">用戶角色</text>
<text name="ConfirmPassword">確認密碼</text>
<text name="EmailAddress">郵箱地址</text>
<text name="Surname">姓</text>
<text name="DeleteUserConfirm">確認刪除該用戶？</text>
<text name="EditUser">編輯用戶</text> <text name="CreateNewTenant">創建新租戶</text>
<text name="DatabaseConnectionString">資料庫連接</text>
<text name="AdminEmailAddress">管理員郵箱地址</text>
<text name="DefaultPasswordIs">預設密碼為：{0}</text>
<text name="DeleteTenantConfirm">確認刪除該租戶？</text>
<text name="EditTenant">編輯租戶</text> </texts>
</localizationDictionary>
编辑资源文件
在领域层(即JD.CRS.Core)的\Localization\SourceFiles\
编辑资源文件(例如CRS.xml)，以下两种方式皆可．
<text name="UserName" value="User Name" />
<text name="UserName">User Name</text>
<?xml version="1.0" encoding="utf-8" ?>
<localizationDictionary culture="en">
<texts>
<text name="AppName" >CRS</text>
<text name="CRS" value="CRS" />
<text name="StartTyping">Start Typing</text>
<text name="Version">Version</text>
<text name="CopyRight" >© 2019 CRS</text>
<text name="HomePage" value="Home page" />
<text name="Data">Data</text>
<text name="Service">Service</text>
<text name="Report">Report</text>
<text name="Setting">Setting</text>
<text name="Office">Office</text>
<text name="Department">Department</text>
<text name="Course">Course</text>
<text name="Instructor">Instructor</text>
<text name="Student">Student</text>
<text name="OfficeInstructor">Office-Allocation</text>
<text name="DepartmentInstructor">Department-Instructor</text>
<text name="DepartmentCourse">Department-Course</text>
<text name="InstructorCourse">Instructor-Course</text>
<text name="StudentCourse">Student-Course</text>
<text name="OfficeReport">Office Report</text>
<text name="DepartmentReport">Department Report</text>
<text name="CourseReport">Course Report</text>
<text name="InstructorReport">Instructor Report</text>
<text name="StudentReport">Student Report</text>
<text name="About" value="About" />
<text name="Skins">Skins</text>
<text name="Settings">Settings</text>
<text name="WelcomeMessage" value="Welcome to CRS!" />
<text name="FormIsNotValidMessage" value="Form is not valid. Please check and fix errors." />
<text name="TenantNameCanNotBeEmpty" value="Tenant name can not be empty" />
<text name="InvalidUserNameOrPassword" value="Invalid user name or password" />
<text name="ThereIsNoTenantDefinedWithName{0}" value="There is no tenant defined with name {0}" />
<text name="TenantIsNotActive" value="Tenant {0} is not active." />
<text name="UserIsNotActiveAndCanNotLogin" value="User {0} is not active and can not log in." />
<text name="UserEmailIsNotConfirmedAndCanNotLogin">Your email address is not confirmed. You can not login.</text>
<text name="UserLockedOutMessage">The user account has been locked out. Please try again later.</text>
<text name="PleaseEnterLoginInformation" value="Please enter login information" />
<text name="TenancyName" value="Tenancy name" />
<text name="UserNameOrEmail" value="User name or email" />
<text name="Password" value="Password" />
<text name="ResetPassword" value="Reset Password" />
<text name="UpdatePassword" value="Update Password" />
<text name="RememberMe" value="Remember me" />
<text name="LogIn" value="Log in" />
<text name="LoginFailed" value="Login failed!" />
<text name="NameSurname" value="Name surname" />
<text name="UserName" value="User name" />
<text name="Name" value="Name" />
<text name="Surname" value="Surname" />
<text name="EmailAddress" value="Email address" />
<text name="Tenants" value="Tenants" />
<text name="SavedSuccessfully" value="Saved successfully" />
<text name="CreateNewTenant" value="Create new tenant" />
<text name="AdminEmailAddress" value="Admin email address" />
<text name="AdminPassword" value="Admin password" />
<text name="Save" value="Save" />
<text name="Cancel" value="Cancel" />
<text name="TenantName_Regex_Description" value="Tenant name must be at least 2 chars, starts with a letter and continue with letter, number, dash or underscore." />
<text name="DefaultPasswordIs" value="Default password is {0}" />
<text name="CanBeEmptyToLoginAsHost" value="Can be empty to login as host." />
<text name="Register" value="Register" />
<text name="OrLoginWith" value="Or login with" />
<text name="WaitingForActivationMessage" value="Your account is waiting to be activated by system admin." />
<text name="TenantSelection" value="Tenant Selection" />
<text name="TenantSelection_Detail" value="Please select one of the following tenants." />
<text name="Logout" value="Logout" />
<text name="RegisterFormUserNameInvalidMessage">Please don't enter an email address for username.</text>
<text name="DatabaseConnectionString" value="Database connection string" />
<text name="Users" value="Users" />
<text name="IsActive" value="Is active" />
<text name="FullName" value="Full name" />
<text name="CreateNewUser" value="Create new user" />
<text name="Yes" value="Yes" />
<text name="No" value="No" />
<text name="Optional" value="Optional" />
<text name="LeaveEmptyToSwitchToHost">Leave empty to switch to the host</text>
<text name="CurrentTenant">Current tenant</text>
<text name="NotSelected">Not selected</text>
<text name="Change">Change</text>
<text name="ChangeTenant">Change tenant</text>
<text name="MultiLevelMenu">Multi Level Menu</text>
<text name="Back">Back</text>
<text name="SuccessfullyRegistered">Successfully registered</text>
<text name="WaitingForEmailActivation">Your email address should be activated</text>
<text name="Roles">Roles</text>
<text name="DisplayName">Display Name</text>
<text name="Edit">Edit</text>
<text name="Delete">Delete</text>
<text name="CreateNewRole">Create new role</text>
<text name="RoleName">Role Name</text>
<text name="Actions">Actions</text>
<text name="CouldNotCompleteLoginOperation">Could not complete login operation. Please try again later.</text>
<text name="CouldNotValidateExternalUser">Could not validate external user</text>
<text name="EditRole">Edit role</text>
<text name="EditTenant">Edit tenant</text>
<text name="EditUser">Edit user</text>
<text name="TenantIdIsNotActive{0}">TenantId {0} is not active</text>
<text name="UnknownTenantId{0}">Unknown tenantId {0}</text>
<text name="ThisFieldIsRequired">This field is required</text>
<text name="PleaseWait">Please wait...</text>
<text name="Administration">Administration</text>
<text name="ClearAll">Clear all</text>
<text name="ClearOthers">Clear others</text>
<text name="LabelOptions">Label options</text>
<text name="Permissions">Permissions</text>
<text name="RoleDescription">Role description</text>
<text name="Create">Create</text>
<text name="UserDetails">User details</text>
<text name="UserRoles">User roles</text>
<text name="ConfirmPassword">Confirm password</text>
<text name="On">On</text>
<text name="Off">Off</text>
<text name="AreYouSureWantToDelete">Are you sure want to delete {0}?</text>
<text name="Filter">Filter</text>
<text name="Refresh">Refresh</text> <text name="CreateCourse">Create Course</text>
<text name="EditCourse">Edit Course</text>
<text name="Code">Code</text>
<text name="DepartmentCode">Department Code</text>
<text name="Credits">Credits</text>
<text name="Remarks">Remarks</text>
<text name="Status">Status</text>
</texts>
</localizationDictionary>
引用资源
在需要引用多语言资源的地方用L("Key")的方式即可．
前端示例
@model JD.CRS.Web.Models.Account.RegisterResultViewModel
@{
ViewBag.Title = L("SuccessfullyRegistered");
}
<div class="card">
<div class="body">
<h4>@L("SuccessfullyRegistered")</h4>
<ul>
<li><span class="text-muted">@L("NameSurname"):</span> @Model.NameAndSurname</li>
<li><span class="text-muted">@L("TenancyName"):</span> @Model.TenancyName</li>
<li><span class="text-muted">@L("UserName"):</span> @Model.UserName</li>
<li><span class="text-muted">@L("EmailAddress"):</span> @Model.EmailAddress</li>
</ul>
<div>
@if (!Model.IsActive)
{
<div class="alert alert-warning" role="alert">
@L("WaitingForActivationMessage")
</div>
} @if (Model.IsEmailConfirmationRequiredForLogin && !Model.IsEmailConfirmed)
{
<div class="alert alert-warning" role="alert">
@L("WaitingForEmailActivation")
</div>
}
</div>
</div>
</div>
后端示例
using System;
using Abp;
using Abp.Authorization;
using Abp.Dependency;
using Abp.UI; namespace JD.CRS.Authorization
{
public class AbpLoginResultTypeHelper : AbpServiceBase, ITransientDependency
{
public AbpLoginResultTypeHelper()
{
LocalizationSourceName = CRSConsts.LocalizationSourceName;
} public Exception CreateExceptionForFailedLoginAttempt(AbpLoginResultType result, string usernameOrEmailAddress, string tenancyName)
{
switch (result)
{
case AbpLoginResultType.Success:
return new Exception("Don't call this method with a success result!");
case AbpLoginResultType.InvalidUserNameOrEmailAddress:
case AbpLoginResultType.InvalidPassword:
return new UserFriendlyException(L("LoginFailed"), L("InvalidUserNameOrPassword"));
case AbpLoginResultType.InvalidTenancyName:
return new UserFriendlyException(L("LoginFailed"), L("ThereIsNoTenantDefinedWithName{0}", tenancyName));
case AbpLoginResultType.TenantIsNotActive:
return new UserFriendlyException(L("LoginFailed"), L("TenantIsNotActive", tenancyName));
case AbpLoginResultType.UserIsNotActive:
return new UserFriendlyException(L("LoginFailed"), L("UserIsNotActiveAndCanNotLogin", usernameOrEmailAddress));
case AbpLoginResultType.UserEmailIsNotConfirmed:
return new UserFriendlyException(L("LoginFailed"), L("UserEmailIsNotConfirmedAndCanNotLogin"));
case AbpLoginResultType.LockedOut:
return new UserFriendlyException(L("LoginFailed"), L("UserLockedOutMessage"));
default: // Can not fall to default actually. But other result types can be added in the future and we may forget to handle it
Logger.Warn("Unhandled login fail reason: " + result);
return new UserFriendlyException(L("LoginFailed"));
}
} public string CreateLocalizedMessageForFailedLoginAttempt(AbpLoginResultType result, string usernameOrEmailAddress, string tenancyName)
{
switch (result)
{
case AbpLoginResultType.Success:
throw new Exception("Don't call this method with a success result!");
case AbpLoginResultType.InvalidUserNameOrEmailAddress:
case AbpLoginResultType.InvalidPassword:
return L("InvalidUserNameOrPassword");
case AbpLoginResultType.InvalidTenancyName:
return L("ThereIsNoTenantDefinedWithName{0}", tenancyName);
case AbpLoginResultType.TenantIsNotActive:
return L("TenantIsNotActive", tenancyName);
case AbpLoginResultType.UserIsNotActive:
return L("UserIsNotActiveAndCanNotLogin", usernameOrEmailAddress);
case AbpLoginResultType.UserEmailIsNotConfirmed:
return L("UserEmailIsNotConfirmedAndCanNotLogin");
default: // Can not fall to default actually. But other result types can be added in the future and we may forget to handle it
Logger.Warn("Unhandled login fail reason: " + result);
return L("LoginFailed");
}
}
}
}