如何在ASP.NET本地化中为特定单词包裹HTML元素？

ASP.NET本地化本身没有直接内置的“标记特定单词并自动包裹HTML元素”的功能，但可以通过以下几种方案实现你需要的效果：

1. 带占位符的资源字符串方案 #

这是最常用的实现方式，通过在资源文件中预留占位符，再在代码中替换为带HTML标记的内容：

具体步骤： #

• 在资源文件（如Resources.resx）中添加键值对：

  键：TermsOfServiceText
  值：Read our Terms of Service {0}.
  

  对应翻译文件（如Resources.es.resx）可同步翻译为：

  键：TermsOfServiceText
  值：Lee nuestros Términos de Servicio {0}.
  

• 在Razor视图或后端代码中，生成带链接的内容并替换占位符：

  // 获取基础本地化文本
  var baseText = _localizer["TermsOfServiceText"];
  // 生成带本地化文本的链接HTML
  var linkText = _localizer["Here"];
  var linkHtml = $"<a href='/tos'>{linkText}</a>";
  // 替换占位符并输出（使用Html.Raw避免HTML内容被编码）
  @Html.Raw(string.Format(baseText, linkHtml))
  

  最终页面会输出符合需求的内容：

  Read our Terms of Service <a href="/tos">here</a>.
  

2. 自定义本地化扩展方法 #

如果需要同时标记多个单词或实现更灵活的规则，可以封装扩展方法统一处理：

示例扩展方法： #

public static class LocalizerExtensions
{
    public static IHtmlContent LocalizeWithMarkup(this IStringLocalizer localizer, string key, Dictionary<string, string> markupReplacements)
    {
        var rawText = localizer[key].Value;
        foreach (var replacement in markupReplacements)
        {
            rawText = rawText.Replace(replacement.Key, replacement.Value);
        }
        return new HtmlString(rawText);
    }
}

使用方式： #

var replacements = new Dictionary<string, string>
{
    {"here", $"<a href='/tos'>{_localizer["Here"]}</a>"}
};

@_localizer.LocalizeWithMarkup("TermsOfServiceText", replacements)

注意事项 #

• 需提前告知翻译人员资源字符串中占位符或标记单词的作用，避免翻译时破坏结构。
• 处理HTML内容时要防范XSS风险，禁止直接使用用户输入的内容作为替换值，必要时先进行HTML编码再处理。

内容的提问来源于stack exchange，提问作者Fredney