配置C#数据库超时需根据数据访问方式设置：1. 连接字符串中通过Connection Timeout设置连接建立超时，默认15秒；2. ADO.NET通过CommandTimeout属性设置命令执行超时，默认30秒；3. Entity Framework在DbContext中设置Database.CommandTimeout或UseSqlServer时配置CommandTimeout；4. Dapper在QueryAsync等方法中通过commandTimeout参数设置。连接超时控制连接建立，命令超时控制查询执行，应合理设置以平衡性能与资源使用。

配置C#应用程序的数据库超时设置主要取决于你使用的数据访问方式，比如 ADO.NET、Entity Framework 或 Dapper。超时设置可以在连接字符串中、命令级别或上下文级别进行调整。以下是常见的设置位置和方法。

1. 在连接字符串中设置连接超时

连接超时（Connection Timeout）控制的是建立数据库连接的最大等待时间，这个值在连接字符串中设置。

示例（SQL Server）：

Server=your-server;Database=YourDB;User Id=sa;Password=pass;Connection Timeout=30;

说明：

Waifulabs

一键生成动漫二次元头像和插图

131

查看详情

– Connection Timeout 默认通常是15秒。
– 这个超时不控制查询执行时间，只控制连接建立过程。

2. 设置命令执行超时（Command Timeout）

命令超时控制的是SQL语句执行的最大时间，超过则抛出异常。这是最常需要调整的超时类型。

使用 ADO.NET 时：

var connection = new SqlConnection(connectionString);
connection.Open();
var command = new SqlCommand(“SELECT * FROM LargeTable”, connection);
command.CommandTimeout = 120; // 单位：秒
var reader = command.ExecuteReader();

说明：

Waifulabs

一键生成动漫二次元头像和插图

131

查看详情

– CommandTimeout 默认为30秒，设为0表示无限制（不推荐生产环境使用）。

3. Entity Framework 中设置超时

如果你使用的是 Entity Framework，可以通过 DbContext 的 Database 属性设置命令超时。

EF6 示例：

using (var context = new YourDbContext())
{
    context.Database.CommandTimeout = 180; // 设置所有命令超时为180秒
    var result = context.YourTable.ToList();
}

Entity Framework Core 示例：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder
        .UseSqlServer(connectionString, options => options.CommandTimeout(120));
}

4. Dapper 中的超时设置

Dapper 基于 IDbConnection，因此超时需在执行方法中显式传入。

using (var connection = new SqlConnection(connectionString))
{
    var result = await connection.QueryAsync(sql, commandTimeout: 60);
}

说明：

Waifulabs

一键生成动漫二次元头像和插图

131

查看详情

– commandTimeout 参数直接控制该次查询的执行时间上限。

基本上就这些。根据你的数据访问技术选择合适的设置方式。连接超时管“连上去”，命令超时管“跑完查询”，别搞混了。合理设置能避免长时间卡顿，也能防止资源浪费。