EF中如何映射数据库Number(5)为string以支持Linq查询？

默认DTO模型类 #

public class Test
{
    public short Id { get; set; }
    public string Name { get; set; }
}

遗留数据库表结构 #

数据库中NAME字段类型为Number(5)，建表语句如下：

CREATE TABLE SCHEME.TABLE_NAME
(
    ID   NUMBER(5) NOT NULL,
    NAME NUMBER(5) NOT NULL
)

查询需求 #

现有查询代码需要通过字符串搜索Name字段：

public dynamic GetResult(string searchString)
{
    return DbContext.Set<Test>()
                    .Where(x => x.Name.Contains(searchString))
                    .FirstOrDefault();
}

问题：默认映射下EF会将string类型按常规字符串处理，无法生成正确SQL，同时需要支持将数据库中的数字类型转换为字符串，且Linq表达式能正常解析Contains操作。

1. 用EF Core值转换器配置字段映射 #

在DbContext的OnModelCreating方法中，通过Fluent API为Name字段配置双向值转换，实现数据库Number(5)与模型string类型的映射：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 映射表和ID字段
    modelBuilder.Entity<Test>()
        .ToTable("TABLE_NAME", "SCHEME")
        .Property(t => t.Id)
        .HasColumnName("ID")
        .HasColumnType("NUMBER(5)");

    // 配置Name字段的双向转换
    modelBuilder.Entity<Test>()
        .Property(t => t.Name)
        .HasColumnName("NAME")
        .HasColumnType("NUMBER(5)")
        .HasConversion(
            // 模型字符串转数据库数字
            v => short.Parse(v),
            // 数据库数字转模型字符串
            v => v.ToString()
        );
}

2. 处理Linq的Contains查询 #

直接用x.Name.Contains(searchString)可能无法被EF正确转换为针对数字字段的SQL，需要结合数据库函数调整查询逻辑：

方法A：用EF.Functions显式转换（以Oracle为例）

利用EF Core的EF.Functions.Like配合数据库的字符串转换函数，实现模糊查询：

public dynamic GetResult(string searchString)
{
    var pattern = $"%{searchString}%";
    return DbContext.Set<Test>()
                    .Where(x => EF.Functions.Like(x.Name.ToString(), pattern))
                    .FirstOrDefault();
}

注：x.Name.ToString()会被EF转换为数据库中的TO_CHAR(NAME)，配合LIKE实现等同于Contains的效果。如果是SQL Server，可替换为CAST(x.Name AS VARCHAR)。

方法B：封装自定义查询扩展

如果想保持业务代码的简洁性，可以封装扩展方法：

public static class TestQueryExtensions
{
    public static IQueryable<Test> WhereNameContains(this IQueryable<Test> query, string searchString)
    {
        var pattern = $"%{searchString}%";
        return query.Where(x => EF.Functions.Like(x.Name.ToString(), pattern));
    }
}

调用时只需：

public dynamic GetResult(string searchString)
{
    return DbContext.Set<Test>()
                    .WhereNameContains(searchString)
                    .FirstOrDefault();
}

注意事项 #

• 确保数据库用户有权限执行字符串转换函数（如Oracle的TO_CHAR、SQL Server的CAST）。
• 大表场景下建议针对转换后的字段创建函数索引，避免全表扫描导致性能问题。

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