ASP.NET 繁簡中文轉換實作：使用 Encode.dll 元件與最佳實踐指南

前言

.NET Framework 內建並未提供繁簡轉換功能，常見做法有：呼叫 Windows API (`MLang`)、使用第三方開源庫 (如 `ChineseConverter`)、或引用現成的 `Encode.dll`。本文以原文提供的 `Encode.dll` 為例，說明整合步驟、代碼範例、注意事項，並提供現代化替代方案。

方案一：使用 Encode.dll (原文方案)

1. 取得元件

下載原文連結提供的 `Encode.dll` (位於專案 `bin/Debug` 目錄)。

2. 專案加入參考

• 方案總管 → 參考 → 右鍵「加入參考」 → 瀏覽選取 `Encode.dll`。
• 確認 `Copy Local = True` (預設)。

3. 命名空間與呼叫代碼

using EncodeMy; // Encode.dll 的命名空間

public class ChineseConverter
{
    private readonly EncodeRobert _converter = new EncodeRobert();

    /// 
簡體轉繁體
    public string ToTraditional(string simplified)
    {
        if (string.IsNullOrEmpty(simplified)) return simplified;
        return _converter.SCTCConvert(ConvertType.Simplified, ConvertType.Traditional, simplified);
    }

    /// 
繁體轉簡體
    public string ToSimplified(string traditional)
    {
        if (string.IsNullOrEmpty(traditional)) return traditional;
        return _converter.SCTCConvert(ConvertType.Traditional, ConvertType.Simplified, traditional);
    }
}

// 使用範例
protected void btnConvert_Click(object sender, EventArgs e)
{
    var converter = new ChineseConverter();
    txtResult.Text = converter.ToTraditional(txtSource.Text);
}

4. EncodeRobert 類別關鍵方法簽章 (反編譯推測)

namespace EncodeMy
{
    public enum ConvertType { Simplified, Traditional }

    public class EncodeRobert
    {
        public string SCTCConvert(ConvertType from, ConvertType to, string input);
    }
}

方案二：現代化跨平台推薦 — ChineseConverter (NuGet)

優點：開源、跨平台 (.NET Core/.NET 5+)、無非托管相依、支援詞彙級轉換、可自訂詞庫。

安裝

dotnet add package ChineseConverter

使用

using ChineseConverter;

public class ModernChineseConverter
{
    public string ToTraditional(string simplified) => 
        ChineseConverter.Convert(simplified, ChineseConversionDirection.SimplifiedToTraditional);

    public string ToSimplified(string traditional) => 
        ChineseConverter.Convert(traditional, ChineseConversionDirection.TraditionalToSimplified);
}

方案三：.NET 6+ 內建 Globalization 支援 (ICU)

// .NET 6+ 需安裝 ICU 全球化資料 (Linux: apt install libicu-dev)
using System.Globalization;

public class IcuChineseConverter
{
    // 注意：CultureInfo 不直接提供繁簡轉換，需搭配 Transliterator (ICU)
    // 目前 .NET 尚未完整暴露 Transliterator API，建議仍用 ChineseConverter 套件
}

方案四：呼叫 Windows 系統 API (mlang.dll) — 僅限 Windows

using System.Runtime.InteropServices;

public class MlangConverter
{
    [DllImport("mlang.dll", CharSet = CharSet.Unicode)]
    private static extern int ConvertINetString(
        ref uint lpdwMode, 
        uint dwEncoding, 
        [MarshalAs(UnmanagedType.LPWStr)] string lpSrcStr, 
        ref int lpcSrcLen, 
        [MarshalAs(UnmanagedType.LPWStr)] StringBuilder lpDstStr, 
        ref int lpcDstLen);

    private const uint MLANGCODEPAGE_CP936 = 936;   // GB2312
    private const uint MLANGCODEPAGE_CP950 = 950;   // Big5
    private const uint MLANGCODEPAGE_UTF8 = 65001;

    // 簡體(GB2312) -> 繁體(Big5)
    public string ToTraditional(string input)
    {
        uint mode = 0;
        int srcLen = input.Length;
        var dst = new StringBuilder(srcLen * 2);
        int dstLen = dst.Capacity;
        
        // 需先轉碼至 GB2312 位元組，再用 mlang 轉 Big5，最後解碼
        // 實作較複雜，略...
        return input; // Placeholder
    }
}

ASP.NET 整合最佳實踐

1. 封裝為靜態輔助類 (單例模式)

public static class ChineseHelper
{
    private static readonly ChineseConverter _converter = new ChineseConverter(); // 或 EncodeRobert
    
    public static string ToTraditional(string input) => 
        string.IsNullOrEmpty(input) ? input : _converter.ToTraditional(input);
    
    public static string ToSimplified(string input) => 
        string.IsNullOrEmpty(input) ? input : _converter.ToSimplified(input);
}

// 頁面使用
lblResult.Text = ChineseHelper.ToTraditional(txtInput.Text);

2. 建立 WebForms 自訂控制項 / MVC HtmlHelper

// MVC Razor 擴充方法
public static class HtmlHelperExtensions
{
    public static IHtmlContent ChineseConvert(this IHtmlHelper html, string text, bool toTraditional)
    {
        var converted = toTraditional ? ChineseHelper.ToTraditional(text) : ChineseHelper.ToSimplified(text);
        return new HtmlString(HttpUtility.HtmlEncode(converted));
    }
}

// View 使用
@Html.ChineseConvert(Model.Description, true)

3. 前端即時轉換 (JavaScript) — 減輕伺服器負擔

// 使用 opencc-js (支援詞彙級、繁簡/異體字/地區用語)
import { Converter } from 'opencc-js';

const converter = new Converter({ from: 'cn', to: 'tw' }); // 簡體->台灣正體
document.getElementById('txtSource').addEventListener('input', function() {
    document.getElementById('txtResult').value = converter(this.value);
});

常見問題與注意事項

總結與選型建議

**核心建議**：新專務請直接採用 **ChineseConverter (NuGet)**，避免舊元件相依與跨平台問題；舊專案維護期可暫用 `Encode.dll`，但規劃遷移路徑。