ASP.NET 物件成員資料繫結器實作：從 MonoRail 啟發的表單自動映射框架

背景動機

MonoRail（Castle Project 早期 MVC 框架）提供強大的 DataBinder：自動將 `Request.Form`/`QueryString` 依照慣例映射至物件屬性，支援巢狀物件、集合、型別轉換、驗證。ASP.NET WebForms 缺乏同等機制，開發者常手寫大量 `entity.Prop = Request["Prop"]` 程式碼。本文實作輕量級繫結器填補此缺口。

核心介面設計

// 型別轉換器介面
public interface IStringConverter {
    object ConvertTo(string value, out bool succeeded);
}

// 內建轉換器範例
public class Int32Converter : IStringConverter {
    public object ConvertTo(string value, out bool succeeded) {
        return int.TryParse(value, out int result) ? (succeeded = true, result) : (succeeded = false, 0);
    }
}

public class DateTimeConverter : IStringConverter {
    public object ConvertTo(string value, out bool succeeded) {
        return DateTime.TryParse(value, out DateTime result) ? (succeeded = true, result) : (succeeded = false, DateTime.MinValue);
    }
}

public class ByteArrayConverter : IStringConverter {  // HttpPostedFile → byte[]
    public object ConvertTo(string value, out bool succeeded) {
        // 實際實作需從 HttpContext.Current.Request.Files 取得
        succeeded = false; return null;
    }
}

繫結上下文與命名慣例

public class BindingContext {
    public HttpRequest Request { get; }
    public IDictionary Converters { get; } = new Dictionary();
    public string Prefix { get; set; }  // 如 "order."、"user.Address."

    public BindingContext(HttpRequest request) => Request = request;

    // 命名對應規則：支援 PropName、PrefixPropName、Prefix_PropName、Prefix.PropName
    public string[] GetPossibleKeys(string propertyName) {
        var keys = new List { propertyName };
        if (!string.IsNullOrEmpty(Prefix)) {
            keys.Add(Prefix + propertyName);
            keys.Add(Prefix + "_" + propertyName);
            keys.Add(Prefix + "." + propertyName);
        }
        return keys.ToArray();
    }
}

核心繫結演算法

public static class ObjectBinder {
    public static T BindObject(BindingContext ctx) where T : new() {
        var obj = new T();
        BindObject(ctx, obj);
        return obj;
    }

    public static void BindObject(BindingContext ctx, object target) {
        var props = target.GetType().GetProperties(BindingFlags.Public | BindingFlags.Instance)
                          .Where(p => p.CanWrite);

        foreach (var prop in props) {
            var keys = ctx.GetPossibleKeys(prop.Name);
            string rawValue = null;
            foreach (var key in keys) {
                rawValue = ctx.Request[key];
                if (rawValue != null) break;
            }
            if (rawValue == null) continue; // 未提供值，保留預設

            // 尋找轉換器
            if (ctx.Converters.TryGetValue(prop.PropertyType.FullName, out var converter) ||
                ctx.Converters.TryGetValue(prop.Name, out converter)) {
                if (converter.ConvertTo(rawValue, out bool ok) is object val && ok) {
                    prop.SetValue(target, val);
                }
            } else if (prop.PropertyType.IsPrimitive || prop.PropertyType == typeof(string) || prop.PropertyType == typeof(decimal)) {
                // 內建型別直接轉換
                var converted = Convert.ChangeType(rawValue, prop.PropertyType);
                prop.SetValue(target, converted);
            } else if (prop.PropertyType.IsClass && prop.PropertyType != typeof(string)) {
                // 巢狀物件遞迴繫結
                var nestedCtx = new BindingContext(ctx.Request) { Prefix = prop.Name + "." };
                var nestedObj = Activator.CreateInstance(prop.PropertyType);
                BindObject(nestedCtx, nestedObj);
                prop.SetValue(target, nestedObj);
            }
        }
    }
}

使用範例

// 註冊全域轉換器 (Application_Start)
BindingContext.GlobalConverters[typeof(DateTime).FullName] = new DateTimeConverter();
BindingContext.GlobalConverters["BirthDate"] = new DateTimeConverter(); // 指定屬性專用

// 頁面中使用
protected void btnSave_Click(object sender, EventArgs e) {
    var ctx = new BindingContext(Request);
    var order = ObjectBinder.BindObject(ctx);
    var customer = ObjectBinder.BindObject(ctx, "cust"); // Prefix="cust."
    OrderService.Save(order, customer);
}

進階功能擴展

• 集合繫結：支援 `Order.Items[0].ProductId`、`Order.Items.Index.Quantity` 索引語法。
• 驗證整合：繫結後執行 `Validator.TryValidateObject`，收集 `ValidationResult` 回顯錯誤。
• ModelState 相容：輸出 `ModelStateDictionary` 供 MVC 風格驗證摘要使用。
• 安全性：白名單 `BindAttribute` / `Include`/`Exclude` 防止過度張貼攻擊。

與 ASP.NET Core Model Binding 比較

總結

自訂物件繫結器以約定優於配置、介面導向型別轉換、遞迴巢狀繫結，大幅減少手動賦值程式碼。雖 ASP.NET Core 內建更強大的模型繫結，但在維護舊版 WebForms 專案、漸進式遷移、特殊格式解析（如舊版加密參數）場景仍具實用價值。

1. 上一篇文章： ASP.NET 網頁列印技術全方位總結：客戶端/伺服器端生成、CSS 分頁、列印模板與最佳實踐
2. 下一篇文章： ASP.NET 常用工具函數精選：DateTime、字串格式化、編碼轉換與數值處理

關於ASP.NET

ASP.NET 應用程式效能監測：使用效能監視器觀察 Request Execution Time

監測 ASP.NET 應用程式效能最簡單且內建的方式，是使用

ASP.NET Web Game 架構設計（一）：伺服器基礎結構——WebGarden、狀態服務、邏輯伺服器分離

三層拓撲 網頁客戶端（JS 處理展示邏輯） IIS Web

ASP.NET 自訂控件開發 第五篷：範本控件開發實戰

範本控件開發比組合控件更簡單，核心在於繼承 Composit

ASP.NET 2.0 資料教程 46：DataList/Repeater 自訂按鈕命令實作

DataList 與 Repeater 內建編輯/刪除按鈕