C# ASP.NET：如何从对象列表生成并向网站返回CSV文件

不用先把CSV存本地啦，直接在内存里生成然后通过响应返回给用户更高效。我给你写两个核心部分的代码：一个负责JSON转对象、生成CSV的工具类，另一个是控制器里的调用方法。

1. CSV生成工具类 #

这个类会帮你把对象列表转换成CSV格式，处理表头、字段转义这些容易踩坑的细节：

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Reflection;
using System.Text.Json;

public static class CsvGenerator
{
    /// <summary>
    /// 将对象列表转换为CSV格式的内存流
    /// </summary>
    /// <typeparam name="T">对象类型</typeparam>
    /// <param name="items">对象列表</param>
    /// <param name="delimiter">CSV分隔符，默认逗号</param>
    /// <returns>包含CSV内容的内存流</returns>
    public static MemoryStream GenerateCsvStream<T>(List<T> items, char delimiter = ',') where T : class
    {
        var stream = new MemoryStream();
        var writer = new StreamWriter(stream, System.Text.Encoding.UTF8);

        // 写入表头（自动取对象的属性名）
        var properties = typeof(T).GetProperties(BindingFlags.Public | BindingFlags.Instance);
        var headerLine = string.Join(delimiter.ToString(), properties.Select(p => EscapeCsvValue(p.Name)));
        writer.WriteLine(headerLine);

        // 逐行写入数据
        foreach (var item in items)
        {
            var values = properties.Select(p => EscapeCsvValue(p.GetValue(item)?.ToString() ?? string.Empty));
            var line = string.Join(delimiter.ToString(), values);
            writer.WriteLine(line);
        }

        writer.Flush();
        stream.Position = 0; // 重置流指针到开头，方便后续读取
        return stream;
    }

    /// <summary>
    /// 转义CSV字段值，处理包含逗号、引号或换行的特殊情况
    /// </summary>
    private static string EscapeCsvValue(string value)
    {
        if (value.Contains(',') || value.Contains('"') || value.Contains('\n') || value.Contains('\r'))
        {
            // 如果包含特殊字符，用双引号包裹，内部的双引号替换为两个双引号（CSV规范要求）
            return $"\"{value.Replace("\"", "\"\"")}\"";
        }
        return value;
    }
}

2. ASP.NET控制器中返回CSV文件 #

在你的控制器里，先从数据库获取JSON数据，转成对象列表，然后调用工具类生成流，最后通过File方法返回给用户：

using Microsoft.AspNetCore.Mvc;
using System.Collections.Generic;
using System.Text.Json;

public class DataController : Controller
{
    public IActionResult DownloadCsv()
    {
        // 1. 从数据库获取JSON数据（替换成你的实际数据查询逻辑）
        string jsonData = FetchJsonFromDatabase();
        
        // 2. 将JSON转换为对象列表（把YourEntity换成你自己的实体类）
        List<YourEntity> entities = JsonSerializer.Deserialize<List<YourEntity>>(jsonData);
        
        // 3. 生成CSV内存流
        var csvStream = CsvGenerator.GenerateCsvStream(entities);
        
        // 4. 返回文件给用户，设置正确的响应头
        return File(
            fileStream: csvStream,
            contentType: "text/csv",
            fileDownloadName: $"exported_data_{DateTime.Now:yyyyMMddHHmmss}.csv"
        );
    }

    // 模拟从数据库获取JSON的方法，实际项目里替换成你的数据库查询逻辑
    private string FetchJsonFromDatabase()
    {
        // 示例JSON数据，实际从数据库读取
        return @"[{""Id"":1,""Username"":""Jesper.Lindberg"",""Email"":""jesper@example.com""},{""Id"":2,""Username"":""AnnaSmith"",""Email"":""anna@example.com""}]";
    }
}

// 替换成你自己的实体类，属性要和JSON结构对应
public class YourEntity
{
    public int Id { get; set; }
    public string Username { get; set; }
    public string Email { get; set; }
}

关键细节说明 #

• 内存流生成：跳过本地文件写入，直接在内存中处理，既节省IO开销，也不用操心文件清理的问题
• CSV规范兼容：EscapeCsvValue方法处理了特殊字符，生成的CSV能被Excel、Numbers等工具正确解析
• 响应设置：text/csv的Content-Type告诉浏览器这是CSV文件，带时间戳的文件名避免用户下载重复文件

这样用户访问/Data/DownloadCsv路径时，浏览器就会自动触发CSV文件的下载啦！

内容的提问来源于stack exchange，提问作者Jesper.Lindberg