ASP.NET 2.0 多語言開發完整指南：資源檔、Profile、Culture、當地語系化

ASP.NET 2.0 引入強大的 **資源檔** 機制，配合 `CultureInfo`、`UICulture`、`Profile`、`InitializeCulture()`，能以最少代碼實現完整的 **多語言/當地語系化 (Globalization/Localization)**。本文從基礎概念到實戰步驟、進階技巧、常見坑點完整解析。

核心概念速覽

資源檔類型與命名規則

命名鐵律：基底檔 (無文化代碼) **必須存在** (如 `Resources.resx`)，否則強型別類別不會產生，編譯失敗。文化特定檔為選用。

實戰步驟：從零建立多語言網站

1. 設定 `web.config`：自動偵測瀏覽器語言 + Profile 記住使用者選擇

<system.web>
  <globalization uiCulture="auto" culture="auto" /> <!-- 自動依 Accept-Language 設定 -->
  <anonymousIdentification enabled="true" />
  <profile>
    <properties>
      <add name="LanguagePreference" type="String" defaultValue="auto" allowAnonymous="true" />
    </properties>
  </profile>
</system.web>

2. 建立 `PageBase` 基類：統一在 `InitializeCulture()` 設定 Culture/UICulture

public class PageBase : System.Web.UI.Page {
    protected override void InitializeCulture() {
        base.InitializeCulture();

        string lang = Profile.LanguagePreference; // 從 Profile 讀取
        if (string.IsNullOrEmpty(lang) || lang == "auto") {
            // 首次造訪：依瀏覽器語言
            if (Request.UserLanguages != null && Request.UserLanguages.Length > 0) {
                lang = Request.UserLanguages[0];
                Profile.LanguagePreference = lang; // 寫回 Profile
            } else {
                lang = "en-US"; // 最終預設
            }
        }

        // 設定當前執行緒文化特性
        Thread.CurrentThread.CurrentUICulture = new CultureInfo(lang);
        Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture(lang);
    }
}

所有 `.aspx.cs` 繼承 `PageBase` 而非 `Page`。

3. 提供語言切換下拉選單 (Master Page / User Control)

<asp:DropDownList ID="ddlLang" runat="server" AutoPostBack="true" OnSelectedIndexChanged="ddlLang_SelectedIndexChanged">
    <asp:ListItem Value="auto" Text="自動 (瀏覽器)" />
    <asp:ListItem Value="en-US" Text="English" />
    <asp:ListItem Value="zh-TW" Text="繁體中文" />
    <asp:ListItem Value="zh-CN" Text="简体中文" />
</asp:DropDownList>

protected void ddlLang_SelectedIndexChanged(object sender, EventArgs e) {
    Profile.LanguagePreference = ddlLang.SelectedValue;
    Response.Redirect(Request.Url.AbsolutePath); // 重新載入頁面套用新文化特性
}

4. 建立資源檔並使用

全域資源 (強型別)：

// App_GlobalResources\Resources.resx (基底)
Name: WelcomeText, Value: "Welcome"
// App_GlobalResources\Resources.zh-TW.resx
Name: WelcomeText, Value: "歡迎光臨"

// 頁面中使用 (IntelliSense 支援)
<asp:Label runat="server" Text="<%$ Resources:Resources, WelcomeText %>" />
// 或程式碼後置
lblWelcome.Text = Resources.Resources.WelcomeText;

區域資源 (隱含/顯式運算式)：

<!-- 隱含運算式：meta:resourcekey 對應資源檔同前綴鍵 -->
<asp:Label ID="lblTitle" runat="server" meta:resourcekey="lblTitle" />
<!-- 資源檔需含：lblTitle.Text, lblTitle.ToolTip 等 -->

<!-- 顯式運算式：指定資源檔與鍵 -->
<asp:Label runat="server" Text="<%$ Resources:Resources, FooterText %>" />

5. 當地語系化圖片 (資源檔支援非字串型別)

1. 在 `Resources.resx` 加入影像 `Logo` (預設 `logo.png`)。
2. 在 `Resources.zh-TW.resx` 加入同名影像 `Logo` (中文版 `logo_zh.png`)。
3. 建立 `ImageHandler.ashx`：

public class ImageHandler : IHttpHandler {
    public void ProcessRequest(HttpContext context) {
        string lang = ((ProfileCommon)context.Profile).LanguagePreference;
        if (!string.IsNullOrEmpty(lang) && lang != "auto") {
            Thread.CurrentThread.CurrentUICulture = new CultureInfo(lang);
        }
        Bitmap bmp = Resources.Resources.Logo; // 強型別存取
        context.Response.ContentType = "image/png";
        bmp.Save(context.Response.OutputStream, ImageFormat.Png);
    }
    public bool IsReusable => false;
}

<asp:Image runat="server" ImageUrl="~/ImageHandler.ashx" />

6. SiteMap 當地語系化

<!-- Web.sitemap -->
<siteMap enableLocalization="true">
  <siteMapNode url="~/Default.aspx" title="Home" description="Home Page" resourceKey="HomeNode" />
</siteMap>

<!-- App_GlobalResources\Web.sitemap.resx -->
Name: HomeNode.Title, Value: "Home"
Name: HomeNode.Description, Value: "Home Page"
<!-- App_GlobalResources\Web.sitemap.zh-TW.resx -->
Name: HomeNode.Title, Value: "首頁"
Name: HomeNode.Description, Value: "首頁說明"

ASP.NET 1.1 vs 2.0 差異快照

常見坑點與解決方案

現代化遷移建議 (ASP.NET Core / 5+)

• 資源檔改為 `.resx` + `IStringLocalizer` / `IHtmlLocalizer` (DI 注入)。
• 文化特性由 `RequestLocalizationMiddleware` 自動偵測 (Header、Cookie、QueryString、Route)。
• `[CultureInfo]`、`[UICulture]` 模型繫結器自動驗證。
• 不再需要 `PageBase`、`InitializeCulture()`、`Profile`，架構更乾淨。

ASP.NET 2.0 的資源檔 + Profile + `InitializeCulture()` 架構在當年極具前瞻性，完整解決了「偵測、持久化、切換、當地語系化、非字串資源」全鏈路問題。理解其設計精髓，對遷移至現代框架同樣受用。