CommandTimeout用于设置数据库命令执行的超时时间，单位为秒，默认通常为30秒。在C#中需为每个SqlCommand实例单独配置，如command.CommandTimeout = 60。EF6通过ObjectContext.CommandTimeout设置，EF Core使用context.Database.SetCommandTimeout(120)，均为上下文级别生效。复杂查询应显式延长超时，简单操作可沿用默认值，推荐按需封装方法灵活传入超时参数，避免因超时导致查询失败。
在C#中配置数据库查询超时，可以通过设置 CommandTimeout 属性来控制每个数据库命令的执行等待时间。这个超时是针对单个命令的，不是全局设置，因此需要为每个需要控制超时的 SqlCommand 实例单独设置。
1. CommandTimeout 是什么？
CommandTimeout 指定命令执行前等待命令完成的时间（以秒为单位）。如果超过这个时间，会抛出 SqlException，提示“超时已过期”。
默认值通常是30秒，不同数据库驱动可能略有差异。
2. 为每个命令单独设置超时
在使用 SqlCommand 时，直接设置其 CommandTimeout 属性即可：
using (var connection = new SqlConnection(connectionString))
{
connection.Open();
using (var command = new SqlCommand("SELECT * FROM LargeTable", connection))
{
command.CommandTimeout = 60; // 设置为60秒
using (var reader = command.ExecuteReader())
{
while (reader.Read())
{
// 处理数据
}
}
}
}
上面的例子中，该查询最多等待60秒，超时则抛出异常。
3. 在 Entity Framework 中设置命令超时
如果你使用的是 EF6 或 EF Core，也可以设置命令超时：
EF6：
((IObjectContextAdapter)context).ObjectContext.CommandTimeout = 120;
EF Core：
context.Database.SetCommandTimeout(120); // 单位：秒
注意：这会影响后续所有命令的超时设置，是上下文级别的，不是每个命令自动重置。
4. 是否必须每个命令都设置？
不需要每个命令都手动设置。通常：
- 简单查询（如查一行、小表）用默认30秒足够。
- 复杂查询、大数据量导出、报表类操作应单独提高超时时间。
- 可以封装一个方法，在创建
SqlCommand时根据场景传入合适的超时值。
例如：
public SqlCommand CreateCommand(SqlConnection conn, string sql, int timeoutSeconds)
{
var cmd = new SqlCommand(sql, conn);
cmd.CommandTimeout = timeoutSeconds;
return cmd;
}
这样可以在调用时灵活控制：CreateCommand(conn, sql, 180) 表示3分钟超时。
基本上就这些。CommandTimeout 是按命令设置的，推荐对长耗时操作显式指定，避免默认超时导致意外失败。
