如何编辑ASP.NET站点并实现采购数据导出CSV适配QuickBooks及站点转HTML

1 ASP.NET站点转静态HTML站点操作路径 #

• 首先完成现有站点资产分类：将现有ASP.NET站点内容划分为静态资源（固定展示页面、图片、CSS/JS、公开资讯/产品介绍等无需用户交互、无需实时读取数据库的内容）和动态逻辑（采购提交、用户查询、数据写入等必须调用服务端能力的模块）
• 静态内容批量导出：小站点页面量较少的情况下，可直接导出所有ASP.NET页面的浏览器渲染结果，清理掉.aspx、.ashx等服务端后缀，统一输出为.html格式文件，原有动态路由可通过静态文件目录结构或者前端路由实现匹配。如果站点页面量较大，可以写简单的爬取脚本批量拉取所有公开页面的渲染结果。
• 动态逻辑适配：如果转换后仍需保留采购等交互功能，可将原有ASP.NET后端改造为纯API服务，所有交互逻辑通过前端JS发起请求调用API实现，静态HTML仅负责页面渲染。如果后续无需保留任何交互功能，仅用作展示，可直接将导出的全量静态文件部署到Nginx、Apache等纯静态Web服务器，无需再保留ASP.NET运行环境和SQL Server数据库。
• 数据库内容迁移：原有SQL Server中存储的静态内容（如产品参数、公开资讯等）可一次性导出为JSON文件，供静态站点前端直接读取，无需再实时连接数据库；采购记录、用户数据等需要写入的动态数据仍保留在SQL Server中，由后端API负责读写。

2 QuickBooks兼容CSV导出功能实现 #

• 先对齐字段规则：QuickBooks对可导入的客户/采购订单CSV有固定的列名、格式要求，核心必填字段包括DisplayName（客户名称）、CompanyName（所属公司）、Email（联系邮箱）、BillAddr.Line1（账单地址）、TxnDate（交易日期）、TotalAmt（交易金额）等，需先确认你使用的QuickBooks版本的字段要求，表头必须和要求完全一致。
• 导出逻辑集成：在原有ASP.NET的采购成功回调逻辑中追加CSV生成代码，C#示例实现如下：

using System.Text;
using System.Linq;

// 从数据库读取当前采购对应的客户&交易数据
var purchaseData = GetCurrentPurchaseDataFromDB();

var csvBuilder = new StringBuilder();
// 写入符合QuickBooks要求的表头
csvBuilder.AppendLine("DisplayName,CompanyName,Email,BillAddr.Line1,TxnDate,TotalAmt");

// 逐行写入数据，注意特殊字符转义
foreach (var item in purchaseData)
{
    var csvLine = string.Format("\"{0}\",\"{1}\",\"{2}\",\"{3}\",{4:yyyy-MM-dd},{5:f2}",
        item.CustomerName.Replace("\"", "\"\""), // 转义内容中的双引号
        item.CompanyName.Replace("\"", "\"\""),
        item.ContactEmail,
        item.BillingAddress.Replace("\"", "\"\""),
        item.PurchaseTime,
        item.TransactionAmount
    );
    csvBuilder.AppendLine(csvLine);
}

// 输出带BOM的UTF-8编码文件，避免QuickBooks识别中文乱码
byte[] csvFileBytes = Encoding.UTF8.GetPreamble()
    .Concat(Encoding.UTF8.GetBytes(csvBuilder.ToString()))
    .ToArray();

• 格式校验：导出的CSV文件可以先手动导入QuickBooks测试，重点校验日期格式、金额精度、特殊字符展示是否正常，避免批量导出后导入报错。

内容的提问来源于stack exchange，提问作者Khris Miller