如何用C#实现数据库的数据传输对象（DTO）？为什么需要？-C#.Net教程-PHP中文网

如何用C#实现数据库的数据传输对象（DTO）？为什么需要？

星降

发布： 2025-09-23 09:07:01

原创

781人浏览过

使用DTO能避免暴露敏感字段、减少数据传输、解耦系统层级并提升兼容性，通过定义如UserDto等类将实体数据安全转换并返回，结合AutoMapper可简化映射过程，API应始终返回DTO而非实体，不同场景可设计对应变体以增强接口清晰度与维护性。

如何用c#实现数据库的数据传输对象（dto）？为什么需要？

在C#开发中，数据传输对象（DTO）是一种设计模式，用于在不同层或系统之间安全、高效地传递数据。它通常是一个简单的类，只包含属性，不包含业务逻辑，主要用于封装需要传输的数据。

为什么需要DTO？

直接使用数据库实体类（Entity）进行数据传输会带来一些问题：

暴露敏感字段：比如密码、内部ID等字段不应该返回给前端。
避免过度传输：前端可能只需要部分字段，传整个实体会造成带宽浪费。
解耦层级：将数据库模型与API输出分离，数据库结构变化不会直接影响接口契约。
跨系统兼容性：不同系统可能对数据结构要求不同，DTO可做适配。

因此，使用DTO能提升安全性、灵活性和可维护性。

如何用C#实现DTO？

下面是一个简单示例，展示从数据库实体到DTO的转换过程。

1. 定义数据库实体（Entity）

假设有一个用户表对应的实体类：

public class User
{
    public int Id { get; set; }
    public string Name { get; set; }
    public string Email { get; set; }
    public string Password { get; set; } // 敏感字段
    public DateTime CreatedAt { get; set; }
}

登录后复制

2. 创建对应的DTO类

只暴露必要的字段：

public class UserDto
{
    public int Id { get; set; }
    public string Name { get; set; }
    public string Email { get; set; }
    public DateTime CreatedAt { get; set; }
}

登录后复制

3. 在服务中进行转换

从Entity转为DTO，可以在服务层手动映射，或使用工具如AutoMapper。

阿里云-虚拟数字人

阿里云-虚拟数字人是什么？ ...

查看详情

手动映射示例：

public UserDto GetUserDto(User user)
{
    return new UserDto
    {
        Id = user.Id,
        Name = user.Name,
        Email = user.Email,
        CreatedAt = user.CreatedAt
    };
}

登录后复制

使用AutoMapper自动映射：

安装NuGet包：

AutoMapper

登录后复制

// 配置映射（通常在启动时注册）
var config = new MapperConfiguration(cfg =>
    cfg.CreateMap<User, UserDto>()
);

IMapper mapper = config.CreateMapper();

// 使用
UserDto dto = mapper.Map<UserDto>(userEntity);

登录后复制

4. 在ASP.NET Core API中返回DTO

控制器应返回DTO而不是实体：

[HttpGet("{id}")]
public IActionResult GetUser(int id)
{
    var user = _context.Users.Find(id);
    if (user == null) return NotFound();

    var dto = mapper.Map<UserDto>(user);
    return Ok(dto);
}

登录后复制