ADO.NET Entity Framework 4 實現 Enum 枚舉映射：Complex Type 包裝器模式

EF4 原生不支援 CLR Enum 直接映射資料庫整數欄位。利用 Complex Type (復雜類型) 包裝 Enum，配合隱式轉換運算子，實現「代碼用 Enum、資料庫存 int」的無縫體驗。需使用 POCO 實體，不可用設計器自動生成類別。

資料庫腳本

CREATE TABLE Account (
    ID uniqueidentifier PRIMARY KEY DEFAULT NEWSEQUENTIALID(),
    UserName nvarchar(20) NOT NULL,
    Password varchar(40) NOT NULL,
    Email nvarchar(100) NOT NULL,
    Role int NOT NULL  -- 對應 Enum
);

INSERT INTO Account (UserName, Password, Email, Role) VALUES
('Test1','Test1','test1',1),
('Test2','Test2','test2',1),
('Test3','Test3','test3',2);

定義 Enum 與包裝器 Complex Type

// 業務枚舉
public enum AccountRoleEnum { Admin = 1, User = 2 }

// Complex Type 包裝器：負責 Enum ↔ int 雙向轉換
public partial class RoleWrapper
{
    private AccountRoleEnum _role;
    
    // EF 映射用：資料庫 int 欄位
    public int Value
    {
        get => (int)_role;
        set => _role = (AccountRoleEnum)value;
    }
    
    // 代碼用：強類型 Enum
    public AccountRoleEnum EnumValue
    {
        get => _role;
        set => _role = value;
    }
    
    // 隱式轉換：Enum → Wrapper
    public static implicit operator RoleWrapper(AccountRoleEnum role)
        => new RoleWrapper { EnumValue = role };
    
    // 隱式轉換：Wrapper → Enum
    public static implicit operator AccountRoleEnum(RoleWrapper wrapper)
        => wrapper?.EnumValue ?? AccountRoleEnum.User;
}

POCO 實體與 ObjectContext

public class Account
{
    public Guid ID { get; set; }
    public string UserName { get; set; }
    public string Password { get; set; }
    public string Email { get; set; }
    public RoleWrapper Role { get; set; }  // 映射 Complex Type
}

public class EntitiesContext : ObjectContext
{
    public EntitiesContext() : base("name=Entities", "Entities")
    {
        _accounts = CreateObjectSet();
    }
    
    public ObjectSet Accounts => _accounts;
    private ObjectSet _accounts;
}

使用示範

// 記憶體比較：直接用 Enum
var admin = ctx.Accounts.FirstOrDefault(a => a.Role == AccountRoleEnum.Admin);

// LINQ to Entities 查詢：必須用 Value (int) 轉 SQL
var admins = ctx.Accounts.Where(a => a.Role.Value == (int)AccountRoleEnum.Admin).ToList();

// 新增/修改：直接賦值 Enum，隱式轉換自動處理
var newAcc = new Account { 
    ID = Guid.NewGuid(), 
    UserName = "Test4", 
    Role = AccountRoleEnum.User  // 隱式轉換為 RoleWrapper
};
ctx.AddObject("Accounts", newAcc);
ctx.SaveChanges();

關鍵限制與注意事項

• LINQ 查詢無法直接用 Enum 比較，會轉譯失敗，必須用 .Value == (int)Enum
• Complex Type 不支援導航屬性、不可為 Null（除非在 EF6+ 配置）
• EDMX 設計器中將 Role 欄位類型設為 RoleWrapper Complex Type
• EF6 / EF Core 內建 HasConversion() 原生支援 Enum，此模式適用於 EF4 維護專案

模式優勢

1. 代碼層享受 Enum 型別安全、IntelliSense、重構支援
2. 資料庫層仍是標準 int，零遷移成本
3. 隱式運算子讓賦值/比較語法極度自然
4. Complex Type 可復用於多個實體的同類枚舉欄位