AlicizaX/com.alicizax.unity.framework
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

修复乱码

Browse Source
This commit is contained in:
陈思海 2026-03-31 19:06:40 +08:00
parent 67e8dd7c00
commit 286a8c0d66
3 changed files with 750 additions and 671 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
Runtime/Localization/LocalizationComponent.cs
View File

@ -1,13 +1,11 @@
using System.Collections.Generic; using System.Collections.Generic;
using Cysharp.Threading.Tasks; using Cysharp.Threading.Tasks;
using AlicizaX.Resource.Runtime; using AlicizaX.Resource.Runtime;
using UnityEngine; using UnityEngine;
namespace AlicizaX.Localization.Runtime namespace AlicizaX.Localization.Runtime
{ {
/// <summary>
/// 本地化组件。
/// </summary>
[DisallowMultipleComponent] [DisallowMultipleComponent]
[AddComponentMenu("Game Framework/Localization")] [AddComponentMenu("Game Framework/Localization")]
public sealed class LocalizationComponent : MonoBehaviour public sealed class LocalizationComponent : MonoBehaviour
@ -53,7 +51,7 @@ namespace AlicizaX.Localization.Runtime
return string.IsNullOrEmpty(language) ? fallback : language; return string.IsNullOrEmpty(language) ? fallback : language;
} }
private void Awake() private void Start()
{ {
if (!AppServices.App.TryGet<ILocalizationService>(out _mLocalizationService)) if (!AppServices.App.TryGet<ILocalizationService>(out _mLocalizationService))
{ {

698
Runtime/Localization/Service/ILocalizationService.cs
View File

@ -5,442 +5,464 @@ using Cysharp.Threading.Tasks;
namespace AlicizaX.Localization.Runtime namespace AlicizaX.Localization.Runtime
{ {
/// <summary> /// <summary>
/// 本地化管理器接口。 /// 定义本地化服务的核心能力，包括语言切换、字符串查询与配置表管理。
/// </summary> /// </summary>
public interface ILocalizationService : IService public interface ILocalizationService : IService
{ {
/// <summary>
/// 获取当前正在使用的语言标识。
/// </summary>
public string Language { get; } public string Language { get; }
/// <summary>
/// 初始化本地化服务并设置当前语言。
/// </summary>
/// <param name="language">要设置或切换到的语言标识。</param>
void Initialize(string language); void Initialize(string language);
/// <summary>
/// 尝试按键获取未格式化的本地化字符串。
/// </summary>
/// <param name="key">本地化字符串的键。</param>
/// <param name="value">输出获取到的原始字符串值。</param>
/// <returns>如果找到对应键则返回 `true`；否则返回 `false`。</returns>
bool TryGetRawString(string key, out string value); bool TryGetRawString(string key, out string value);
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取本地化字符串。
/// </summary> /// </summary>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回本地化结果；若键不存在则返回缺失标记字符串。</returns>
string GetString(string key); string GetString(string key);
/// <summary>
/// 请求切换当前语言。
/// </summary>
/// <param name="language">要设置或切换到的语言标识。</param>
void ChangedLanguage(string language); void ChangedLanguage(string language);
/// <summary>
/// 异步切换当前语言并刷新已跟踪的本地化数据。
/// </summary>
/// <param name="language">要设置或切换到的语言标识。</param>
/// <param name="cancellationToken">用于取消异步切换操作的令牌。</param>
/// <returns>表示语言切换流程的异步任务。</returns>
UniTask SwitchLanguageAsync(string language, CancellationToken cancellationToken = default); UniTask SwitchLanguageAsync(string language, CancellationToken cancellationToken = default);
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T">字典参数的类型。</typeparam> /// <param name="key">本地化字符串的键。</param>
/// <param name="key">字典主键。</param> /// <param name="args">用于格式化本地化字符串的参数列表。</param>
/// <param name="args">字典参数列表。</param> /// <returns>返回本地化结果；若键不存在则返回缺失标记字符串。</returns>
/// <returns>要获取的字典内容字符串。</returns>
string GetString(string key, params object[] args); string GetString(string key, params object[] args);
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T">字典参数的类型。</typeparam> /// <typeparam name="T">格式化参数的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg">字典参数。</param> /// <param name="arg">用于格式化本地化字符串的参数。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
string GetString<T>(string key, T arg); string GetString<T>(string key, T arg);
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
string GetString<T1, T2>(string key, T1 arg1, T2 arg2); string GetString<T1, T2>(string key, T1 arg1, T2 arg2);
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
string GetString<T1, T2, T3>(string key, T1 arg1, T2 arg2, T3 arg3); string GetString<T1, T2, T3>(string key, T1 arg1, T2 arg2, T3 arg3);
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
string GetString<T1, T2, T3, T4>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4); string GetString<T1, T2, T3, T4>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4);
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
string GetString<T1, T2, T3, T4, T5>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5); string GetString<T1, T2, T3, T4, T5>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5);
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <typeparam name="T6">字典参数 6 的类型。</typeparam> /// <typeparam name="T6">格式化参数 6 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <param name="arg6">字典参数 6。</param> /// <param name="arg6">用于格式化本地化字符串的参数 6。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
string GetString<T1, T2, T3, T4, T5, T6>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6); string GetString<T1, T2, T3, T4, T5, T6>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6);
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <typeparam name="T6">字典参数 6 的类型。</typeparam> /// <typeparam name="T6">格式化参数 6 的类型。</typeparam>
/// <typeparam name="T7">字典参数 7 的类型。</typeparam> /// <typeparam name="T7">格式化参数 7 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <param name="arg6">字典参数 6。</param> /// <param name="arg6">用于格式化本地化字符串的参数 6。</param>
/// <param name="arg7">字典参数 7。</param> /// <param name="arg7">用于格式化本地化字符串的参数 7。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
string GetString<T1, T2, T3, T4, T5, T6, T7>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7); string GetString<T1, T2, T3, T4, T5, T6, T7>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7);
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <typeparam name="T6">字典参数 6 的类型。</typeparam> /// <typeparam name="T6">格式化参数 6 的类型。</typeparam>
/// <typeparam name="T7">字典参数 7 的类型。</typeparam> /// <typeparam name="T7">格式化参数 7 的类型。</typeparam>
/// <typeparam name="T8">字典参数 8 的类型。</typeparam> /// <typeparam name="T8">格式化参数 8 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <param name="arg6">字典参数 6。</param> /// <param name="arg6">用于格式化本地化字符串的参数 6。</param>
/// <param name="arg7">字典参数 7。</param> /// <param name="arg7">用于格式化本地化字符串的参数 7。</param>
/// <param name="arg8">字典参数 8。</param> /// <param name="arg8">用于格式化本地化字符串的参数 8。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
string GetString<T1, T2, T3, T4, T5, T6, T7, T8>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8); string GetString<T1, T2, T3, T4, T5, T6, T7, T8>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8);
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <typeparam name="T6">字典参数 6 的类型。</typeparam> /// <typeparam name="T6">格式化参数 6 的类型。</typeparam>
/// <typeparam name="T7">字典参数 7 的类型。</typeparam> /// <typeparam name="T7">格式化参数 7 的类型。</typeparam>
/// <typeparam name="T8">字典参数 8 的类型。</typeparam> /// <typeparam name="T8">格式化参数 8 的类型。</typeparam>
/// <typeparam name="T9">字典参数 9 的类型。</typeparam> /// <typeparam name="T9">格式化参数 9 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <param name="arg6">字典参数 6。</param> /// <param name="arg6">用于格式化本地化字符串的参数 6。</param>
/// <param name="arg7">字典参数 7。</param> /// <param name="arg7">用于格式化本地化字符串的参数 7。</param>
/// <param name="arg8">字典参数 8。</param> /// <param name="arg8">用于格式化本地化字符串的参数 8。</param>
/// <param name="arg9">字典参数 9。</param> /// <param name="arg9">用于格式化本地化字符串的参数 9。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9); string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9);
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <typeparam name="T6">字典参数 6 的类型。</typeparam> /// <typeparam name="T6">格式化参数 6 的类型。</typeparam>
/// <typeparam name="T7">字典参数 7 的类型。</typeparam> /// <typeparam name="T7">格式化参数 7 的类型。</typeparam>
/// <typeparam name="T8">字典参数 8 的类型。</typeparam> /// <typeparam name="T8">格式化参数 8 的类型。</typeparam>
/// <typeparam name="T9">字典参数 9 的类型。</typeparam> /// <typeparam name="T9">格式化参数 9 的类型。</typeparam>
/// <typeparam name="T10">字典参数 10 的类型。</typeparam> /// <typeparam name="T10">格式化参数 10 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <param name="arg6">字典参数 6。</param> /// <param name="arg6">用于格式化本地化字符串的参数 6。</param>
/// <param name="arg7">字典参数 7。</param> /// <param name="arg7">用于格式化本地化字符串的参数 7。</param>
/// <param name="arg8">字典参数 8。</param> /// <param name="arg8">用于格式化本地化字符串的参数 8。</param>
/// <param name="arg9">字典参数 9。</param> /// <param name="arg9">用于格式化本地化字符串的参数 9。</param>
/// <param name="arg10">字典参数 10。</param> /// <param name="arg10">用于格式化本地化字符串的参数 10。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10); string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10);
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <typeparam name="T6">字典参数 6 的类型。</typeparam> /// <typeparam name="T6">格式化参数 6 的类型。</typeparam>
/// <typeparam name="T7">字典参数 7 的类型。</typeparam> /// <typeparam name="T7">格式化参数 7 的类型。</typeparam>
/// <typeparam name="T8">字典参数 8 的类型。</typeparam> /// <typeparam name="T8">格式化参数 8 的类型。</typeparam>
/// <typeparam name="T9">字典参数 9 的类型。</typeparam> /// <typeparam name="T9">格式化参数 9 的类型。</typeparam>
/// <typeparam name="T10">字典参数 10 的类型。</typeparam> /// <typeparam name="T10">格式化参数 10 的类型。</typeparam>
/// <typeparam name="T11">字典参数 11 的类型。</typeparam> /// <typeparam name="T11">格式化参数 11 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <param name="arg6">字典参数 6。</param> /// <param name="arg6">用于格式化本地化字符串的参数 6。</param>
/// <param name="arg7">字典参数 7。</param> /// <param name="arg7">用于格式化本地化字符串的参数 7。</param>
/// <param name="arg8">字典参数 8。</param> /// <param name="arg8">用于格式化本地化字符串的参数 8。</param>
/// <param name="arg9">字典参数 9。</param> /// <param name="arg9">用于格式化本地化字符串的参数 9。</param>
/// <param name="arg10">字典参数 10。</param> /// <param name="arg10">用于格式化本地化字符串的参数 10。</param>
/// <param name="arg11">字典参数 11。</param> /// <param name="arg11">用于格式化本地化字符串的参数 11。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11); string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11);
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <typeparam name="T6">字典参数 6 的类型。</typeparam> /// <typeparam name="T6">格式化参数 6 的类型。</typeparam>
/// <typeparam name="T7">字典参数 7 的类型。</typeparam> /// <typeparam name="T7">格式化参数 7 的类型。</typeparam>
/// <typeparam name="T8">字典参数 8 的类型。</typeparam> /// <typeparam name="T8">格式化参数 8 的类型。</typeparam>
/// <typeparam name="T9">字典参数 9 的类型。</typeparam> /// <typeparam name="T9">格式化参数 9 的类型。</typeparam>
/// <typeparam name="T10">字典参数 10 的类型。</typeparam> /// <typeparam name="T10">格式化参数 10 的类型。</typeparam>
/// <typeparam name="T11">字典参数 11 的类型。</typeparam> /// <typeparam name="T11">格式化参数 11 的类型。</typeparam>
/// <typeparam name="T12">字典参数 12 的类型。</typeparam> /// <typeparam name="T12">格式化参数 12 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <param name="arg6">字典参数 6。</param> /// <param name="arg6">用于格式化本地化字符串的参数 6。</param>
/// <param name="arg7">字典参数 7。</param> /// <param name="arg7">用于格式化本地化字符串的参数 7。</param>
/// <param name="arg8">字典参数 8。</param> /// <param name="arg8">用于格式化本地化字符串的参数 8。</param>
/// <param name="arg9">字典参数 9。</param> /// <param name="arg9">用于格式化本地化字符串的参数 9。</param>
/// <param name="arg10">字典参数 10。</param> /// <param name="arg10">用于格式化本地化字符串的参数 10。</param>
/// <param name="arg11">字典参数 11。</param> /// <param name="arg11">用于格式化本地化字符串的参数 11。</param>
/// <param name="arg12">字典参数 12。</param> /// <param name="arg12">用于格式化本地化字符串的参数 12。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11, T12 arg12); string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11, T12 arg12);
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <typeparam name="T6">字典参数 6 的类型。</typeparam> /// <typeparam name="T6">格式化参数 6 的类型。</typeparam>
/// <typeparam name="T7">字典参数 7 的类型。</typeparam> /// <typeparam name="T7">格式化参数 7 的类型。</typeparam>
/// <typeparam name="T8">字典参数 8 的类型。</typeparam> /// <typeparam name="T8">格式化参数 8 的类型。</typeparam>
/// <typeparam name="T9">字典参数 9 的类型。</typeparam> /// <typeparam name="T9">格式化参数 9 的类型。</typeparam>
/// <typeparam name="T10">字典参数 10 的类型。</typeparam> /// <typeparam name="T10">格式化参数 10 的类型。</typeparam>
/// <typeparam name="T11">字典参数 11 的类型。</typeparam> /// <typeparam name="T11">格式化参数 11 的类型。</typeparam>
/// <typeparam name="T12">字典参数 12 的类型。</typeparam> /// <typeparam name="T12">格式化参数 12 的类型。</typeparam>
/// <typeparam name="T13">字典参数 13 的类型。</typeparam> /// <typeparam name="T13">格式化参数 13 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <param name="arg6">字典参数 6。</param> /// <param name="arg6">用于格式化本地化字符串的参数 6。</param>
/// <param name="arg7">字典参数 7。</param> /// <param name="arg7">用于格式化本地化字符串的参数 7。</param>
/// <param name="arg8">字典参数 8。</param> /// <param name="arg8">用于格式化本地化字符串的参数 8。</param>
/// <param name="arg9">字典参数 9。</param> /// <param name="arg9">用于格式化本地化字符串的参数 9。</param>
/// <param name="arg10">字典参数 10。</param> /// <param name="arg10">用于格式化本地化字符串的参数 10。</param>
/// <param name="arg11">字典参数 11。</param> /// <param name="arg11">用于格式化本地化字符串的参数 11。</param>
/// <param name="arg12">字典参数 12。</param> /// <param name="arg12">用于格式化本地化字符串的参数 12。</param>
/// <param name="arg13">字典参数 13。</param> /// <param name="arg13">用于格式化本地化字符串的参数 13。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11, T12 arg12, T13 arg13); string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11, T12 arg12, T13 arg13);
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <typeparam name="T6">字典参数 6 的类型。</typeparam> /// <typeparam name="T6">格式化参数 6 的类型。</typeparam>
/// <typeparam name="T7">字典参数 7 的类型。</typeparam> /// <typeparam name="T7">格式化参数 7 的类型。</typeparam>
/// <typeparam name="T8">字典参数 8 的类型。</typeparam> /// <typeparam name="T8">格式化参数 8 的类型。</typeparam>
/// <typeparam name="T9">字典参数 9 的类型。</typeparam> /// <typeparam name="T9">格式化参数 9 的类型。</typeparam>
/// <typeparam name="T10">字典参数 10 的类型。</typeparam> /// <typeparam name="T10">格式化参数 10 的类型。</typeparam>
/// <typeparam name="T11">字典参数 11 的类型。</typeparam> /// <typeparam name="T11">格式化参数 11 的类型。</typeparam>
/// <typeparam name="T12">字典参数 12 的类型。</typeparam> /// <typeparam name="T12">格式化参数 12 的类型。</typeparam>
/// <typeparam name="T13">字典参数 13 的类型。</typeparam> /// <typeparam name="T13">格式化参数 13 的类型。</typeparam>
/// <typeparam name="T14">字典参数 14 的类型。</typeparam> /// <typeparam name="T14">格式化参数 14 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <param name="arg6">字典参数 6。</param> /// <param name="arg6">用于格式化本地化字符串的参数 6。</param>
/// <param name="arg7">字典参数 7。</param> /// <param name="arg7">用于格式化本地化字符串的参数 7。</param>
/// <param name="arg8">字典参数 8。</param> /// <param name="arg8">用于格式化本地化字符串的参数 8。</param>
/// <param name="arg9">字典参数 9。</param> /// <param name="arg9">用于格式化本地化字符串的参数 9。</param>
/// <param name="arg10">字典参数 10。</param> /// <param name="arg10">用于格式化本地化字符串的参数 10。</param>
/// <param name="arg11">字典参数 11。</param> /// <param name="arg11">用于格式化本地化字符串的参数 11。</param>
/// <param name="arg12">字典参数 12。</param> /// <param name="arg12">用于格式化本地化字符串的参数 12。</param>
/// <param name="arg13">字典参数 13。</param> /// <param name="arg13">用于格式化本地化字符串的参数 13。</param>
/// <param name="arg14">字典参数 14。</param> /// <param name="arg14">用于格式化本地化字符串的参数 14。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11, T12 arg12, T13 arg13, T14 arg14); string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11, T12 arg12, T13 arg13, T14 arg14);
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <typeparam name="T6">字典参数 6 的类型。</typeparam> /// <typeparam name="T6">格式化参数 6 的类型。</typeparam>
/// <typeparam name="T7">字典参数 7 的类型。</typeparam> /// <typeparam name="T7">格式化参数 7 的类型。</typeparam>
/// <typeparam name="T8">字典参数 8 的类型。</typeparam> /// <typeparam name="T8">格式化参数 8 的类型。</typeparam>
/// <typeparam name="T9">字典参数 9 的类型。</typeparam> /// <typeparam name="T9">格式化参数 9 的类型。</typeparam>
/// <typeparam name="T10">字典参数 10 的类型。</typeparam> /// <typeparam name="T10">格式化参数 10 的类型。</typeparam>
/// <typeparam name="T11">字典参数 11 的类型。</typeparam> /// <typeparam name="T11">格式化参数 11 的类型。</typeparam>
/// <typeparam name="T12">字典参数 12 的类型。</typeparam> /// <typeparam name="T12">格式化参数 12 的类型。</typeparam>
/// <typeparam name="T13">字典参数 13 的类型。</typeparam> /// <typeparam name="T13">格式化参数 13 的类型。</typeparam>
/// <typeparam name="T14">字典参数 14 的类型。</typeparam> /// <typeparam name="T14">格式化参数 14 的类型。</typeparam>
/// <typeparam name="T15">字典参数 15 的类型。</typeparam> /// <typeparam name="T15">格式化参数 15 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <param name="arg6">字典参数 6。</param> /// <param name="arg6">用于格式化本地化字符串的参数 6。</param>
/// <param name="arg7">字典参数 7。</param> /// <param name="arg7">用于格式化本地化字符串的参数 7。</param>
/// <param name="arg8">字典参数 8。</param> /// <param name="arg8">用于格式化本地化字符串的参数 8。</param>
/// <param name="arg9">字典参数 9。</param> /// <param name="arg9">用于格式化本地化字符串的参数 9。</param>
/// <param name="arg10">字典参数 10。</param> /// <param name="arg10">用于格式化本地化字符串的参数 10。</param>
/// <param name="arg11">字典参数 11。</param> /// <param name="arg11">用于格式化本地化字符串的参数 11。</param>
/// <param name="arg12">字典参数 12。</param> /// <param name="arg12">用于格式化本地化字符串的参数 12。</param>
/// <param name="arg13">字典参数 13。</param> /// <param name="arg13">用于格式化本地化字符串的参数 13。</param>
/// <param name="arg14">字典参数 14。</param> /// <param name="arg14">用于格式化本地化字符串的参数 14。</param>
/// <param name="arg15">字典参数 15。</param> /// <param name="arg15">用于格式化本地化字符串的参数 15。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11, T12 arg12, T13 arg13, T14 arg14, T15 arg15); string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11, T12 arg12, T13 arg13, T14 arg14, T15 arg15);
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <typeparam name="T6">字典参数 6 的类型。</typeparam> /// <typeparam name="T6">格式化参数 6 的类型。</typeparam>
/// <typeparam name="T7">字典参数 7 的类型。</typeparam> /// <typeparam name="T7">格式化参数 7 的类型。</typeparam>
/// <typeparam name="T8">字典参数 8 的类型。</typeparam> /// <typeparam name="T8">格式化参数 8 的类型。</typeparam>
/// <typeparam name="T9">字典参数 9 的类型。</typeparam> /// <typeparam name="T9">格式化参数 9 的类型。</typeparam>
/// <typeparam name="T10">字典参数 10 的类型。</typeparam> /// <typeparam name="T10">格式化参数 10 的类型。</typeparam>
/// <typeparam name="T11">字典参数 11 的类型。</typeparam> /// <typeparam name="T11">格式化参数 11 的类型。</typeparam>
/// <typeparam name="T12">字典参数 12 的类型。</typeparam> /// <typeparam name="T12">格式化参数 12 的类型。</typeparam>
/// <typeparam name="T13">字典参数 13 的类型。</typeparam> /// <typeparam name="T13">格式化参数 13 的类型。</typeparam>
/// <typeparam name="T14">字典参数 14 的类型。</typeparam> /// <typeparam name="T14">格式化参数 14 的类型。</typeparam>
/// <typeparam name="T15">字典参数 15 的类型。</typeparam> /// <typeparam name="T15">格式化参数 15 的类型。</typeparam>
/// <typeparam name="T16">字典参数 16 的类型。</typeparam> /// <typeparam name="T16">格式化参数 16 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <param name="arg6">字典参数 6。</param> /// <param name="arg6">用于格式化本地化字符串的参数 6。</param>
/// <param name="arg7">字典参数 7。</param> /// <param name="arg7">用于格式化本地化字符串的参数 7。</param>
/// <param name="arg8">字典参数 8。</param> /// <param name="arg8">用于格式化本地化字符串的参数 8。</param>
/// <param name="arg9">字典参数 9。</param> /// <param name="arg9">用于格式化本地化字符串的参数 9。</param>
/// <param name="arg10">字典参数 10。</param> /// <param name="arg10">用于格式化本地化字符串的参数 10。</param>
/// <param name="arg11">字典参数 11。</param> /// <param name="arg11">用于格式化本地化字符串的参数 11。</param>
/// <param name="arg12">字典参数 12。</param> /// <param name="arg12">用于格式化本地化字符串的参数 12。</param>
/// <param name="arg13">字典参数 13。</param> /// <param name="arg13">用于格式化本地化字符串的参数 13。</param>
/// <param name="arg14">字典参数 14。</param> /// <param name="arg14">用于格式化本地化字符串的参数 14。</param>
/// <param name="arg15">字典参数 15。</param> /// <param name="arg15">用于格式化本地化字符串的参数 15。</param>
/// <param name="arg16">字典参数 16。</param> /// <param name="arg16">用于格式化本地化字符串的参数 16。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11, T12 arg12, T13 arg13, T14 arg14, T15 arg15, T16 arg16); string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11, T12 arg12, T13 arg13, T14 arg14, T15 arg15, T16 arg16);
/// <summary> /// <summary>
/// 根据字典主键获取字典值。 /// 按键获取未格式化的本地化字符串。
/// </summary> /// </summary>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <returns>字典值。</returns> /// <returns>返回原始本地化字符串；若键不存在则返回 `null`。</returns>
string GetRawString(string key); string GetRawString(string key);
/// <summary> /// <summary>
/// 增量增加多语言配置 /// 以增量方式添加本地化配置表内容。
/// </summary> /// </summary>
/// <param name="table"></param> /// <param name="table">要处理的本地化配置表。</param>
void IncreAddLocalizationConfig(GameLocaizationTable table); void IncreAddLocalizationConfig(GameLocaizationTable table);
/// <summary> /// <summary>
/// 覆盖增加多语言配置 /// 清空当前数据后，用指定配置表覆盖本地化内容。
/// </summary> /// </summary>
/// <param name="table"></param> /// <param name="table">要处理的本地化配置表。</param>
void CoverAddLocalizationConfig(GameLocaizationTable table); void CoverAddLocalizationConfig(GameLocaizationTable table);
/// <summary> /// <summary>
/// 重新加载指定多语言表当前语言的数据。 /// 重新加载指定配置表在当前语言下的内容。
/// </summary> /// </summary>
/// <param name="table">目标多语言表。</param> /// <param name="table">要处理的本地化配置表。</param>
void ReloadLocalizationConfig(GameLocaizationTable table); void ReloadLocalizationConfig(GameLocaizationTable table);
} }
} }

715
Runtime/Localization/Service/LocalizationService.cs
View File

@ -7,26 +7,54 @@ using Cysharp.Threading.Tasks;
namespace AlicizaX.Localization.Runtime namespace AlicizaX.Localization.Runtime
{ {
/// <summary> /// <summary>
/// 本地化管理器。 /// 本地化服务实现，负责维护当前语言对应的字符串缓存，并管理配置表的装载与刷新。
/// </summary> /// </summary>
[UnityEngine.Scripting.Preserve] [UnityEngine.Scripting.Preserve]
internal sealed partial class LocalizationService : ServiceBase, ILocalizationService internal sealed partial class LocalizationService : ServiceBase, ILocalizationService
{ {
/// <summary>
/// 存储当前语言下可用的本地化键值映射。
/// </summary>
private readonly Dictionary<string, string> Dic = new(); private readonly Dictionary<string, string> Dic = new();
/// <summary>
/// 记录已被服务跟踪的本地化配置表。
/// </summary>
private readonly List<GameLocaizationTable> _trackedTables = new(); private readonly List<GameLocaizationTable> _trackedTables = new();
/// <summary>
/// 记录每个配置表当前写入到缓存中的键集合，便于重载时移除旧数据。
/// </summary>
private readonly Dictionary<GameLocaizationTable, List<string>> _trackedTableKeys = new(); private readonly Dictionary<GameLocaizationTable, List<string>> _trackedTableKeys = new();
/// <summary>
/// 保存当前启用的语言标识。
/// </summary>
private string _language; private string _language;
/// <summary>
/// 获取当前正在使用的语言标识。
/// </summary>
public string Language public string Language
{ {
get => _language; get => _language;
} }
/// <summary>
/// 请求切换当前语言。
/// </summary>
/// <param name="language">要设置或切换到的语言标识。</param>
public void ChangedLanguage(string language) public void ChangedLanguage(string language)
{ {
SwitchLanguageAsync(language).Forget(); SwitchLanguageAsync(language).Forget();
} }
/// <summary>
/// 异步切换当前语言并刷新已跟踪的本地化数据。
/// </summary>
/// <param name="language">要设置或切换到的语言标识。</param>
/// <param name="cancellationToken">用于取消异步切换操作的令牌。</param>
/// <returns>表示语言切换流程的异步任务。</returns>
public UniTask SwitchLanguageAsync(string language, CancellationToken cancellationToken = default) public UniTask SwitchLanguageAsync(string language, CancellationToken cancellationToken = default)
{ {
cancellationToken.ThrowIfCancellationRequested(); cancellationToken.ThrowIfCancellationRequested();
@ -42,6 +70,10 @@ namespace AlicizaX.Localization.Runtime
return UniTask.CompletedTask; return UniTask.CompletedTask;
} }
/// <summary>
/// 初始化本地化服务并设置当前语言。
/// </summary>
/// <param name="language">要设置或切换到的语言标识。</param>
public void Initialize(string language) public void Initialize(string language)
{ {
_language = language; _language = language;
@ -49,16 +81,22 @@ namespace AlicizaX.Localization.Runtime
Log.Info($"Initializing LocalizationModule :{language}"); Log.Info($"Initializing LocalizationModule :{language}");
} }
/// <summary>
/// 尝试按键获取未格式化的本地化字符串。
/// </summary>
/// <param name="key">本地化字符串的键。</param>
/// <param name="value">输出获取到的原始字符串值。</param>
/// <returns>如果找到对应键则返回 `true`；否则返回 `false`。</returns>
public bool TryGetRawString(string key, out string value) public bool TryGetRawString(string key, out string value)
{ {
return Dic.TryGetValue(key, out value); return Dic.TryGetValue(key, out value);
} }
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取本地化字符串。
/// </summary> /// </summary>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回本地化结果；若键不存在则返回缺失标记字符串。</returns>
public string GetString(string key) public string GetString(string key)
{ {
if (!Dic.TryGetValue(key, out string value)) if (!Dic.TryGetValue(key, out string value))
@ -70,11 +108,11 @@ namespace AlicizaX.Localization.Runtime
} }
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取本地化字符串。
/// </summary> /// </summary>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="args">参数列表.</param> /// <param name="args">用于格式化本地化字符串的参数列表。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回本地化结果；若键不存在则返回缺失标记字符串。</returns>
public string GetString(string key, params object[] args) public string GetString(string key, params object[] args)
{ {
if (!Dic.TryGetValue(key, out string value)) if (!Dic.TryGetValue(key, out string value))
@ -86,12 +124,12 @@ namespace AlicizaX.Localization.Runtime
} }
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T">字典参数的类型。</typeparam> /// <typeparam name="T">格式化参数的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg">字典参数。</param> /// <param name="arg">用于格式化本地化字符串的参数。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
public string GetString<T>(string key, T arg) public string GetString<T>(string key, T arg)
{ {
if (!Dic.TryGetValue(key, out string value)) if (!Dic.TryGetValue(key, out string value))
@ -110,14 +148,14 @@ namespace AlicizaX.Localization.Runtime
} }
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
public string GetString<T1, T2>(string key, T1 arg1, T2 arg2) public string GetString<T1, T2>(string key, T1 arg1, T2 arg2)
{ {
if (!Dic.TryGetValue(key, out string value)) if (!Dic.TryGetValue(key, out string value))
@ -136,16 +174,16 @@ namespace AlicizaX.Localization.Runtime
} }
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
public string GetString<T1, T2, T3>(string key, T1 arg1, T2 arg2, T3 arg3) public string GetString<T1, T2, T3>(string key, T1 arg1, T2 arg2, T3 arg3)
{ {
if (!Dic.TryGetValue(key, out string value)) if (!Dic.TryGetValue(key, out string value))
@ -164,18 +202,18 @@ namespace AlicizaX.Localization.Runtime
} }
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
public string GetString<T1, T2, T3, T4>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4) public string GetString<T1, T2, T3, T4>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4)
{ {
if (!Dic.TryGetValue(key, out string value)) if (!Dic.TryGetValue(key, out string value))
@ -194,20 +232,20 @@ namespace AlicizaX.Localization.Runtime
} }
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
public string GetString<T1, T2, T3, T4, T5>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5) public string GetString<T1, T2, T3, T4, T5>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5)
{ {
if (!Dic.TryGetValue(key, out string value)) if (!Dic.TryGetValue(key, out string value))
@ -226,22 +264,22 @@ namespace AlicizaX.Localization.Runtime
} }
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <typeparam name="T6">字典参数 6 的类型。</typeparam> /// <typeparam name="T6">格式化参数 6 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <param name="arg6">字典参数 6。</param> /// <param name="arg6">用于格式化本地化字符串的参数 6。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
public string GetString<T1, T2, T3, T4, T5, T6>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6) public string GetString<T1, T2, T3, T4, T5, T6>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6)
{ {
if (!Dic.TryGetValue(key, out string value)) if (!Dic.TryGetValue(key, out string value))
@ -260,24 +298,24 @@ namespace AlicizaX.Localization.Runtime
} }
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <typeparam name="T6">字典参数 6 的类型。</typeparam> /// <typeparam name="T6">格式化参数 6 的类型。</typeparam>
/// <typeparam name="T7">字典参数 7 的类型。</typeparam> /// <typeparam name="T7">格式化参数 7 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <param name="arg6">字典参数 6。</param> /// <param name="arg6">用于格式化本地化字符串的参数 6。</param>
/// <param name="arg7">字典参数 7。</param> /// <param name="arg7">用于格式化本地化字符串的参数 7。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
public string GetString<T1, T2, T3, T4, T5, T6, T7>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7) public string GetString<T1, T2, T3, T4, T5, T6, T7>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7)
{ {
if (!Dic.TryGetValue(key, out string value)) if (!Dic.TryGetValue(key, out string value))
@ -296,26 +334,26 @@ namespace AlicizaX.Localization.Runtime
} }
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <typeparam name="T6">字典参数 6 的类型。</typeparam> /// <typeparam name="T6">格式化参数 6 的类型。</typeparam>
/// <typeparam name="T7">字典参数 7 的类型。</typeparam> /// <typeparam name="T7">格式化参数 7 的类型。</typeparam>
/// <typeparam name="T8">字典参数 8 的类型。</typeparam> /// <typeparam name="T8">格式化参数 8 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <param name="arg6">字典参数 6。</param> /// <param name="arg6">用于格式化本地化字符串的参数 6。</param>
/// <param name="arg7">字典参数 7。</param> /// <param name="arg7">用于格式化本地化字符串的参数 7。</param>
/// <param name="arg8">字典参数 8。</param> /// <param name="arg8">用于格式化本地化字符串的参数 8。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
public string GetString<T1, T2, T3, T4, T5, T6, T7, T8>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8) public string GetString<T1, T2, T3, T4, T5, T6, T7, T8>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8)
{ {
if (!Dic.TryGetValue(key, out string value)) if (!Dic.TryGetValue(key, out string value))
@ -334,28 +372,28 @@ namespace AlicizaX.Localization.Runtime
} }
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <typeparam name="T6">字典参数 6 的类型。</typeparam> /// <typeparam name="T6">格式化参数 6 的类型。</typeparam>
/// <typeparam name="T7">字典参数 7 的类型。</typeparam> /// <typeparam name="T7">格式化参数 7 的类型。</typeparam>
/// <typeparam name="T8">字典参数 8 的类型。</typeparam> /// <typeparam name="T8">格式化参数 8 的类型。</typeparam>
/// <typeparam name="T9">字典参数 9 的类型。</typeparam> /// <typeparam name="T9">格式化参数 9 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <param name="arg6">字典参数 6。</param> /// <param name="arg6">用于格式化本地化字符串的参数 6。</param>
/// <param name="arg7">字典参数 7。</param> /// <param name="arg7">用于格式化本地化字符串的参数 7。</param>
/// <param name="arg8">字典参数 8。</param> /// <param name="arg8">用于格式化本地化字符串的参数 8。</param>
/// <param name="arg9">字典参数 9。</param> /// <param name="arg9">用于格式化本地化字符串的参数 9。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
public string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9) public string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9)
{ {
if (!Dic.TryGetValue(key, out string value)) if (!Dic.TryGetValue(key, out string value))
@ -374,30 +412,30 @@ namespace AlicizaX.Localization.Runtime
} }
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <typeparam name="T6">字典参数 6 的类型。</typeparam> /// <typeparam name="T6">格式化参数 6 的类型。</typeparam>
/// <typeparam name="T7">字典参数 7 的类型。</typeparam> /// <typeparam name="T7">格式化参数 7 的类型。</typeparam>
/// <typeparam name="T8">字典参数 8 的类型。</typeparam> /// <typeparam name="T8">格式化参数 8 的类型。</typeparam>
/// <typeparam name="T9">字典参数 9 的类型。</typeparam> /// <typeparam name="T9">格式化参数 9 的类型。</typeparam>
/// <typeparam name="T10">字典参数 10 的类型。</typeparam> /// <typeparam name="T10">格式化参数 10 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <param name="arg6">字典参数 6。</param> /// <param name="arg6">用于格式化本地化字符串的参数 6。</param>
/// <param name="arg7">字典参数 7。</param> /// <param name="arg7">用于格式化本地化字符串的参数 7。</param>
/// <param name="arg8">字典参数 8。</param> /// <param name="arg8">用于格式化本地化字符串的参数 8。</param>
/// <param name="arg9">字典参数 9。</param> /// <param name="arg9">用于格式化本地化字符串的参数 9。</param>
/// <param name="arg10">字典参数 10。</param> /// <param name="arg10">用于格式化本地化字符串的参数 10。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
public string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10) public string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10)
{ {
if (!Dic.TryGetValue(key, out string value)) if (!Dic.TryGetValue(key, out string value))
@ -416,32 +454,32 @@ namespace AlicizaX.Localization.Runtime
} }
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <typeparam name="T6">字典参数 6 的类型。</typeparam> /// <typeparam name="T6">格式化参数 6 的类型。</typeparam>
/// <typeparam name="T7">字典参数 7 的类型。</typeparam> /// <typeparam name="T7">格式化参数 7 的类型。</typeparam>
/// <typeparam name="T8">字典参数 8 的类型。</typeparam> /// <typeparam name="T8">格式化参数 8 的类型。</typeparam>
/// <typeparam name="T9">字典参数 9 的类型。</typeparam> /// <typeparam name="T9">格式化参数 9 的类型。</typeparam>
/// <typeparam name="T10">字典参数 10 的类型。</typeparam> /// <typeparam name="T10">格式化参数 10 的类型。</typeparam>
/// <typeparam name="T11">字典参数 11 的类型。</typeparam> /// <typeparam name="T11">格式化参数 11 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <param name="arg6">字典参数 6。</param> /// <param name="arg6">用于格式化本地化字符串的参数 6。</param>
/// <param name="arg7">字典参数 7。</param> /// <param name="arg7">用于格式化本地化字符串的参数 7。</param>
/// <param name="arg8">字典参数 8。</param> /// <param name="arg8">用于格式化本地化字符串的参数 8。</param>
/// <param name="arg9">字典参数 9。</param> /// <param name="arg9">用于格式化本地化字符串的参数 9。</param>
/// <param name="arg10">字典参数 10。</param> /// <param name="arg10">用于格式化本地化字符串的参数 10。</param>
/// <param name="arg11">字典参数 11。</param> /// <param name="arg11">用于格式化本地化字符串的参数 11。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
public string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11) public string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11)
{ {
if (!Dic.TryGetValue(key, out string value)) if (!Dic.TryGetValue(key, out string value))
@ -460,34 +498,34 @@ namespace AlicizaX.Localization.Runtime
} }
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <typeparam name="T6">字典参数 6 的类型。</typeparam> /// <typeparam name="T6">格式化参数 6 的类型。</typeparam>
/// <typeparam name="T7">字典参数 7 的类型。</typeparam> /// <typeparam name="T7">格式化参数 7 的类型。</typeparam>
/// <typeparam name="T8">字典参数 8 的类型。</typeparam> /// <typeparam name="T8">格式化参数 8 的类型。</typeparam>
/// <typeparam name="T9">字典参数 9 的类型。</typeparam> /// <typeparam name="T9">格式化参数 9 的类型。</typeparam>
/// <typeparam name="T10">字典参数 10 的类型。</typeparam> /// <typeparam name="T10">格式化参数 10 的类型。</typeparam>
/// <typeparam name="T11">字典参数 11 的类型。</typeparam> /// <typeparam name="T11">格式化参数 11 的类型。</typeparam>
/// <typeparam name="T12">字典参数 12 的类型。</typeparam> /// <typeparam name="T12">格式化参数 12 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <param name="arg6">字典参数 6。</param> /// <param name="arg6">用于格式化本地化字符串的参数 6。</param>
/// <param name="arg7">字典参数 7。</param> /// <param name="arg7">用于格式化本地化字符串的参数 7。</param>
/// <param name="arg8">字典参数 8。</param> /// <param name="arg8">用于格式化本地化字符串的参数 8。</param>
/// <param name="arg9">字典参数 9。</param> /// <param name="arg9">用于格式化本地化字符串的参数 9。</param>
/// <param name="arg10">字典参数 10。</param> /// <param name="arg10">用于格式化本地化字符串的参数 10。</param>
/// <param name="arg11">字典参数 11。</param> /// <param name="arg11">用于格式化本地化字符串的参数 11。</param>
/// <param name="arg12">字典参数 12。</param> /// <param name="arg12">用于格式化本地化字符串的参数 12。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
public string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11, T12 arg12) public string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11, T12 arg12)
{ {
if (!Dic.TryGetValue(key, out string value)) if (!Dic.TryGetValue(key, out string value))
@ -506,36 +544,36 @@ namespace AlicizaX.Localization.Runtime
} }
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <typeparam name="T6">字典参数 6 的类型。</typeparam> /// <typeparam name="T6">格式化参数 6 的类型。</typeparam>
/// <typeparam name="T7">字典参数 7 的类型。</typeparam> /// <typeparam name="T7">格式化参数 7 的类型。</typeparam>
/// <typeparam name="T8">字典参数 8 的类型。</typeparam> /// <typeparam name="T8">格式化参数 8 的类型。</typeparam>
/// <typeparam name="T9">字典参数 9 的类型。</typeparam> /// <typeparam name="T9">格式化参数 9 的类型。</typeparam>
/// <typeparam name="T10">字典参数 10 的类型。</typeparam> /// <typeparam name="T10">格式化参数 10 的类型。</typeparam>
/// <typeparam name="T11">字典参数 11 的类型。</typeparam> /// <typeparam name="T11">格式化参数 11 的类型。</typeparam>
/// <typeparam name="T12">字典参数 12 的类型。</typeparam> /// <typeparam name="T12">格式化参数 12 的类型。</typeparam>
/// <typeparam name="T13">字典参数 13 的类型。</typeparam> /// <typeparam name="T13">格式化参数 13 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <param name="arg6">字典参数 6。</param> /// <param name="arg6">用于格式化本地化字符串的参数 6。</param>
/// <param name="arg7">字典参数 7。</param> /// <param name="arg7">用于格式化本地化字符串的参数 7。</param>
/// <param name="arg8">字典参数 8。</param> /// <param name="arg8">用于格式化本地化字符串的参数 8。</param>
/// <param name="arg9">字典参数 9。</param> /// <param name="arg9">用于格式化本地化字符串的参数 9。</param>
/// <param name="arg10">字典参数 10。</param> /// <param name="arg10">用于格式化本地化字符串的参数 10。</param>
/// <param name="arg11">字典参数 11。</param> /// <param name="arg11">用于格式化本地化字符串的参数 11。</param>
/// <param name="arg12">字典参数 12。</param> /// <param name="arg12">用于格式化本地化字符串的参数 12。</param>
/// <param name="arg13">字典参数 13。</param> /// <param name="arg13">用于格式化本地化字符串的参数 13。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
public string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11, T12 arg12, T13 arg13) public string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11, T12 arg12, T13 arg13)
{ {
if (!Dic.TryGetValue(key, out string value)) if (!Dic.TryGetValue(key, out string value))
@ -554,38 +592,38 @@ namespace AlicizaX.Localization.Runtime
} }
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <typeparam name="T6">字典参数 6 的类型。</typeparam> /// <typeparam name="T6">格式化参数 6 的类型。</typeparam>
/// <typeparam name="T7">字典参数 7 的类型。</typeparam> /// <typeparam name="T7">格式化参数 7 的类型。</typeparam>
/// <typeparam name="T8">字典参数 8 的类型。</typeparam> /// <typeparam name="T8">格式化参数 8 的类型。</typeparam>
/// <typeparam name="T9">字典参数 9 的类型。</typeparam> /// <typeparam name="T9">格式化参数 9 的类型。</typeparam>
/// <typeparam name="T10">字典参数 10 的类型。</typeparam> /// <typeparam name="T10">格式化参数 10 的类型。</typeparam>
/// <typeparam name="T11">字典参数 11 的类型。</typeparam> /// <typeparam name="T11">格式化参数 11 的类型。</typeparam>
/// <typeparam name="T12">字典参数 12 的类型。</typeparam> /// <typeparam name="T12">格式化参数 12 的类型。</typeparam>
/// <typeparam name="T13">字典参数 13 的类型。</typeparam> /// <typeparam name="T13">格式化参数 13 的类型。</typeparam>
/// <typeparam name="T14">字典参数 14 的类型。</typeparam> /// <typeparam name="T14">格式化参数 14 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <param name="arg6">字典参数 6。</param> /// <param name="arg6">用于格式化本地化字符串的参数 6。</param>
/// <param name="arg7">字典参数 7。</param> /// <param name="arg7">用于格式化本地化字符串的参数 7。</param>
/// <param name="arg8">字典参数 8。</param> /// <param name="arg8">用于格式化本地化字符串的参数 8。</param>
/// <param name="arg9">字典参数 9。</param> /// <param name="arg9">用于格式化本地化字符串的参数 9。</param>
/// <param name="arg10">字典参数 10。</param> /// <param name="arg10">用于格式化本地化字符串的参数 10。</param>
/// <param name="arg11">字典参数 11。</param> /// <param name="arg11">用于格式化本地化字符串的参数 11。</param>
/// <param name="arg12">字典参数 12。</param> /// <param name="arg12">用于格式化本地化字符串的参数 12。</param>
/// <param name="arg13">字典参数 13。</param> /// <param name="arg13">用于格式化本地化字符串的参数 13。</param>
/// <param name="arg14">字典参数 14。</param> /// <param name="arg14">用于格式化本地化字符串的参数 14。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
public string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11, T12 arg12, T13 arg13, T14 arg14) public string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11, T12 arg12, T13 arg13, T14 arg14)
{ {
if (!Dic.TryGetValue(key, out string value)) if (!Dic.TryGetValue(key, out string value))
@ -605,40 +643,40 @@ namespace AlicizaX.Localization.Runtime
} }
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <typeparam name="T6">字典参数 6 的类型。</typeparam> /// <typeparam name="T6">格式化参数 6 的类型。</typeparam>
/// <typeparam name="T7">字典参数 7 的类型。</typeparam> /// <typeparam name="T7">格式化参数 7 的类型。</typeparam>
/// <typeparam name="T8">字典参数 8 的类型。</typeparam> /// <typeparam name="T8">格式化参数 8 的类型。</typeparam>
/// <typeparam name="T9">字典参数 9 的类型。</typeparam> /// <typeparam name="T9">格式化参数 9 的类型。</typeparam>
/// <typeparam name="T10">字典参数 10 的类型。</typeparam> /// <typeparam name="T10">格式化参数 10 的类型。</typeparam>
/// <typeparam name="T11">字典参数 11 的类型。</typeparam> /// <typeparam name="T11">格式化参数 11 的类型。</typeparam>
/// <typeparam name="T12">字典参数 12 的类型。</typeparam> /// <typeparam name="T12">格式化参数 12 的类型。</typeparam>
/// <typeparam name="T13">字典参数 13 的类型。</typeparam> /// <typeparam name="T13">格式化参数 13 的类型。</typeparam>
/// <typeparam name="T14">字典参数 14 的类型。</typeparam> /// <typeparam name="T14">格式化参数 14 的类型。</typeparam>
/// <typeparam name="T15">字典参数 15 的类型。</typeparam> /// <typeparam name="T15">格式化参数 15 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <param name="key">本地化字符串的键。</param>
/// <param name="arg1">字典参数 1。</param> /// <param name="arg1">用于格式化本地化字符串的参数 1。</param>
/// <param name="arg2">字典参数 2。</param> /// <param name="arg2">用于格式化本地化字符串的参数 2。</param>
/// <param name="arg3">字典参数 3。</param> /// <param name="arg3">用于格式化本地化字符串的参数 3。</param>
/// <param name="arg4">字典参数 4。</param> /// <param name="arg4">用于格式化本地化字符串的参数 4。</param>
/// <param name="arg5">字典参数 5。</param> /// <param name="arg5">用于格式化本地化字符串的参数 5。</param>
/// <param name="arg6">字典参数 6。</param> /// <param name="arg6">用于格式化本地化字符串的参数 6。</param>
/// <param name="arg7">字典参数 7。</param> /// <param name="arg7">用于格式化本地化字符串的参数 7。</param>
/// <param name="arg8">字典参数 8。</param> /// <param name="arg8">用于格式化本地化字符串的参数 8。</param>
/// <param name="arg9">字典参数 9。</param> /// <param name="arg9">用于格式化本地化字符串的参数 9。</param>
/// <param name="arg10">字典参数 10。</param> /// <param name="arg10">用于格式化本地化字符串的参数 10。</param>
/// <param name="arg11">字典参数 11。</param> /// <param name="arg11">用于格式化本地化字符串的参数 11。</param>
/// <param name="arg12">字典参数 12。</param> /// <param name="arg12">用于格式化本地化字符串的参数 12。</param>
/// <param name="arg13">字典参数 13。</param> /// <param name="arg13">用于格式化本地化字符串的参数 13。</param>
/// <param name="arg14">字典参数 14。</param> /// <param name="arg14">用于格式化本地化字符串的参数 14。</param>
/// <param name="arg15">字典参数 15。</param> /// <param name="arg15">用于格式化本地化字符串的参数 15。</param>
/// <returns>要获取的字典内容字符串。</returns> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
public string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11, T12 arg12, T13 arg13, T14 arg14, T15 arg15) public string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11, T12 arg12, T13 arg13, T14 arg14, T15 arg15)
{ {
if (!Dic.TryGetValue(key, out string value)) if (!Dic.TryGetValue(key, out string value))
@ -658,42 +696,25 @@ namespace AlicizaX.Localization.Runtime
} }
/// <summary> /// <summary>
/// 根据字典主键获取字典内容字符串。 /// 按键获取并格式化本地化字符串。
/// </summary> /// </summary>
/// <typeparam name="T1">字典参数 1 的类型。</typeparam> /// <typeparam name="T1">格式化参数 1 的类型。</typeparam>
/// <typeparam name="T2">字典参数 2 的类型。</typeparam> /// <typeparam name="T2">格式化参数 2 的类型。</typeparam>
/// <typeparam name="T3">字典参数 3 的类型。</typeparam> /// <typeparam name="T3">格式化参数 3 的类型。</typeparam>
/// <typeparam name="T4">字典参数 4 的类型。</typeparam> /// <typeparam name="T4">格式化参数 4 的类型。</typeparam>
/// <typeparam name="T5">字典参数 5 的类型。</typeparam> /// <typeparam name="T5">格式化参数 5 的类型。</typeparam>
/// <typeparam name="T6">字典参数 6 的类型。</typeparam> /// <typeparam name="T6">格式化参数 6 的类型。</typeparam>
/// <typeparam name="T7">字典参数 7 的类型。</typeparam> /// <typeparam name="T7">格式化参数 7 的类型。</typeparam>
/// <typeparam name="T8">字典参数 8 的类型。</typeparam> /// <typeparam name="T8">格式化参数 8 的类型。</typeparam>
/// <typeparam name="T9">字典参数 9 的类型。</typeparam> /// <typeparam name="T9">格式化参数 9 的类型。</typeparam>
/// <typeparam name="T10">字典参数 10 的类型。</typeparam> /// <typeparam name="T10">格式化参数 10 的类型。</typeparam>
/// <typeparam name="T11">字典参数 11 的类型。</typeparam> /// <typeparam name="T11">格式化参数 11 的类型。</typeparam>
/// <typeparam name="T12">字典参数 12 的类型。</typeparam> /// <typeparam name="T12">格式化参数 12 的类型。</typeparam>
/// <typeparam name="T13">字典参数 13 的类型。</typeparam> /// <typeparam name="T13">格式化参数 13 的类型。</typeparam>
/// <typeparam name="T14">字典参数 14 的类型。</typeparam> /// <typeparam name="T14">格式化参数 14 的类型。</typeparam>
/// <typeparam name="T15">字典参数 15 的类型。</typeparam> /// <typeparam name="T15">格式化参数 15 的类型。</typeparam>
/// <typeparam name="T16">字典参数 16 的类型。</typeparam> /// <typeparam name="T16">格式化参数 16 的类型。</typeparam>
/// <param name="key">字典主键。</param> /// <returns>返回格式化后的本地化结果；若键不存在则返回缺失标记字符串。</returns>
/// <param name="arg1">字典参数 1。</param>
/// <param name="arg2">字典参数 2。</param>
/// <param name="arg3">字典参数 3。</param>
/// <param name="arg4">字典参数 4。</param>
/// <param name="arg5">字典参数 5。</param>
/// <param name="arg6">字典参数 6。</param>
/// <param name="arg7">字典参数 7。</param>
/// <param name="arg8">字典参数 8。</param>
/// <param name="arg9">字典参数 9。</param>
/// <param name="arg10">字典参数 10。</param>
/// <param name="arg11">字典参数 11。</param>
/// <param name="arg12">字典参数 12。</param>
/// <param name="arg13">字典参数 13。</param>
/// <param name="arg14">字典参数 14。</param>
/// <param name="arg15">字典参数 15。</param>
/// <param name="arg16">字典参数 16。</param>
/// <returns>要获取的字典内容字符串。</returns>
public string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11, T12 arg12, T13 arg13, T14 arg14, public string GetString<T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, T12, T13, T14, T15, T16>(string key, T1 arg1, T2 arg2, T3 arg3, T4 arg4, T5 arg5, T6 arg6, T7 arg7, T8 arg8, T9 arg9, T10 arg10, T11 arg11, T12 arg12, T13 arg13, T14 arg14,
T15 arg15, T16 arg16) T15 arg15, T16 arg16)
{ {
@ -713,17 +734,30 @@ namespace AlicizaX.Localization.Runtime
} }
} }
/// <summary>
/// 按键获取未格式化的本地化字符串。
/// </summary>
/// <param name="key">本地化字符串的键。</param>
/// <returns>返回原始本地化字符串；若键不存在则返回 `null`。</returns>
public string GetRawString(string key) public string GetRawString(string key)
{ {
return TryGetRawString(key, out string value) ? value : null; return TryGetRawString(key, out string value) ? value : null;
} }
/// <summary>
/// 以增量方式添加本地化配置表内容。
/// </summary>
/// <param name="table">要处理的本地化配置表。</param>
public void IncreAddLocalizationConfig(GameLocaizationTable table) public void IncreAddLocalizationConfig(GameLocaizationTable table)
{ {
TrackTable(table); TrackTable(table);
ReapplyTrackedTable(table); ReapplyTrackedTable(table);
} }
/// <summary>
/// 清空当前数据后，用指定配置表覆盖本地化内容。
/// </summary>
/// <param name="table">要处理的本地化配置表。</param>
public void CoverAddLocalizationConfig(GameLocaizationTable table) public void CoverAddLocalizationConfig(GameLocaizationTable table)
{ {
Dic.Clear(); Dic.Clear();
@ -733,14 +767,24 @@ namespace AlicizaX.Localization.Runtime
ReapplyTrackedTable(table); ReapplyTrackedTable(table);
} }
/// <summary>
/// 重新加载指定配置表在当前语言下的内容。
/// </summary>
/// <param name="table">要处理的本地化配置表。</param>
public void ReloadLocalizationConfig(GameLocaizationTable table) public void ReloadLocalizationConfig(GameLocaizationTable table)
{ {
TrackTable(table); TrackTable(table);
ReapplyTrackedTable(table); ReapplyTrackedTable(table);
} }
/// <summary>
/// 初始化本地化服务并设置当前语言。
/// </summary>
protected override void OnInitialize() { } protected override void OnInitialize() { }
/// <summary>
/// 销毁服务时清理已缓存的本地化数据。
/// </summary>
protected override void OnDestroyService() protected override void OnDestroyService()
{ {
Dic.Clear(); Dic.Clear();
@ -748,6 +792,10 @@ namespace AlicizaX.Localization.Runtime
_trackedTableKeys.Clear(); _trackedTableKeys.Clear();
} }
/// <summary>
/// 将配置表加入跟踪列表，便于后续语言切换时重新应用。
/// </summary>
/// <param name="table">要处理的本地化配置表。</param>
private void TrackTable(GameLocaizationTable table) private void TrackTable(GameLocaizationTable table)
{ {
if (table == null) if (table == null)
@ -761,6 +809,9 @@ namespace AlicizaX.Localization.Runtime
} }
} }
/// <summary>
/// 按当前语言重新构建所有已跟踪配置表的缓存内容。
/// </summary>
private void RebuildTrackedTables() private void RebuildTrackedTables()
{ {
Dic.Clear(); Dic.Clear();
@ -772,6 +823,10 @@ namespace AlicizaX.Localization.Runtime
} }
} }
/// <summary>
/// 重新将指定配置表在当前语言下的内容写入缓存。
/// </summary>
/// <param name="table">要处理的本地化配置表。</param>
private void ReapplyTrackedTable(GameLocaizationTable table) private void ReapplyTrackedTable(GameLocaizationTable table)
{ {
if (table == null) if (table == null)
@ -800,6 +855,10 @@ namespace AlicizaX.Localization.Runtime
_trackedTableKeys[table] = keys; _trackedTableKeys[table] = keys;
} }
/// <summary>
/// 从缓存中移除指定配置表此前写入的所有键值。
/// </summary>
/// <param name="table">要处理的本地化配置表。</param>
private void RemoveTrackedTableEntries(GameLocaizationTable table) private void RemoveTrackedTableEntries(GameLocaizationTable table)
{ {
if (!_trackedTableKeys.TryGetValue(table, out List<string> keys)) if (!_trackedTableKeys.TryGetValue(table, out List<string> keys))