DataTable初始化需先定义列再添加行，否则抛异常；Fill()要求连接已打开且参数完整；Select()性能差且语法受限，推荐AsEnumerable().Where()；跨层传递应转强类型而非裸DataTable。
DataTable 初始化和基础数据填充
新建 DataTable 后必须先定义列，否则调用 Rows.Add() 会抛出 InvalidOperationException: “该行已经属于另一个表。” 或更常见的 NullReferenceException（因为列未创建，行无法绑定 schema）。
正确做法是：先用 Columns.Add() 显式声明列名和类型，再逐行 Rows.Add()；或者用 Load() 从 DataReader 填充（自动推导 schema）。
DataTable dt = new DataTable(); dt.Columns.Add("Id", typeof(int)); dt.Columns.Add("Name", typeof(string));- 添加行时，传入的值顺序、数量、类型必须严格匹配列定义，否则运行时报错
ArgumentException: “提供的值与列的数据类型不匹配。” - 避免直接用
new DataRow()——DataRow只能由所属DataTable.NewRow()创建，否则会报ArgumentException: “该行不属于此表。”
从数据库查询结果快速构建 DataTable
最常用也最容易出错的是用 SqlDataAdapter.Fill()。很多人忽略连接状态或命令执行上下文，导致 Fill() 返回 0 行但无异常。
关键点：连接必须是 Open 状态；SqlCommand 的 Connection 和 CommandText 必须已设置；若 SQL 含参数，需确保参数已赋值，否则可能查到空结果或报 SqlException: “必须声明标量变量 @xxx。”
using (var conn = new SqlConnection(connStr)) { conn.Open(); var adapter = new SqlDataAdapter("SELECT id,name FROM users", conn); adapter.Fill(dt); }- 如果只想要 schema 不要数据，用
adapter.FillSchema(dt, SchemaType.Source)，之后可手动填数据 - 注意：SQL Server 的
datetime字段在DataTable中映射为DateTime，但若数据库值为NULL，对应单元格是DBNull.Value，不是null—— 直接 (string)row["Name"] 会崩，得先判row["Name"] != DBNull.Value
DataTable 查询与筛选：别滥用 Select() 方法
DataTable.Select() 看似方便，但实际是字符串解析式，不支持 LINQ 那样的强类型，且性能差、易出错。它用的是老式过滤语法（类似 SQL WHERE），但不支持子查询、JOIN、函数嵌套。
常见翻车点：dt.Select("Name LIKE '%john%'") 中单引号必须双写（''）才能表示字面单引号；日期比较必须用 #2024-01-01# 格式；字段名含空格或特殊字符得加方括号，如 [User Name]。
- 安全替代方案：用
AsEnumerable().Where(...)（需引用System.Data.DataSetExtensions）—— 支持完整 C# 表达式，类型检查在编译期 -
Select()返回新DataRow[]，不修改原表；而DefaultView.RowFilter是动态视图，影响后续遍历行为 - 大量数据下反复调用
Select()会显著拖慢，建议提前用DataView设置Sort+RowFilter，或转成List<T>再查
DataTable 序列化与跨层传递的坑
把 DataTable 当作 DTO 在 Web API 或服务间传递？小心反序列化失败或丢失约束信息。默认 JSON.NET 对 DataTable 的序列化只保留数据，丢弃 PrimaryKey、UniqueConstraint、AutoIncrement 等元数据，且列类型全变成 string 或 object。
更隐蔽的问题：WCF 默认禁用 DataTable 序列化（需显式配置 DataContractSerializer 并开启 generateDatabaseSchema）；.NET Core 中甚至不内置支持。
- 对外暴露数据，优先转成强类型
List<UserDto>或JsonElement，而非裸DataTable - 若必须传，用
dt.WriteXml(stream, XmlWriteMode.WriteSchema)保 schema，再读时用ReadXml()—— 但 XML 体积大、解析慢 - DataTable 的
RemotingFormat属性设为SerializationFormat.Binary可用于 .NET 进程内高效复制，但不可跨语言或跨平台
真正麻烦的从来不是“怎么建表”，而是“什么时候不该用 DataTable”——比如做高频计算、前端分页、微服务通信，它往往是最重、最不透明的那个选择。
