C#中如何配置数据库命令的超时时间?在哪里设置?

来源:这里教程网 时间:2026-02-21 17:28:29 作者:

在C#中配置数据库命令的超时时间,主要是通过设置 CommandTimeout 属性来实现。这个属性属于 DbCommand 类(如 SqlCommand),用于控制命令执行等待的最大秒数。超过这个时间,如果命令还未完成,就会抛出超时异常。

在哪里设置 CommandTimeout?

你可以在创建数据库命令对象后,手动设置 CommandTimeout 属性。以下以 SQL Server 的 SqlCommand 为例:

示例代码:

using (var connection = new SqlConnection(connectionString))
{
    connection.Open();
    using (var command = new SqlCommand("YourStoredProcedureOrQuery", connection))
    {
        command.CommandTimeout = 120; // 设置超时时间为120秒
        command.CommandType = CommandType.StoredProcedure;
        
        var result = command.ExecuteNonQuery();
    }
}

CommandTimeout 的默认值是多少?

默认情况下,CommandTimeout 的值是 30 秒。这意味着如果你不显式设置,任何执行时间超过30秒的命令都会触发超时异常。

值为 0 表示“无限制”,命令将一直等待直到完成(不推荐在生产环境使用) 值为正整数,单位是秒

连接字符串中能设置吗?

不能。连接字符串中的 Connection Timeout 是控制“建立连接”的最长时间,而不是命令执行的超时时间。这两个是不同的概念:

Connection Timeout:连接数据库服务器的最长等待时间(默认通常是15秒) CommandTimeout:命令执行的最长等待时间(默认30秒)

Entity Framework 中如何设置?

如果你使用的是 Entity Framework,可以通过 DbContext.Database 来设置命令超时:

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

基本上就这些。关键点是:在执行命令前设置 CommandTimeout,根据业务需要合理设定时间,避免长时间阻塞或意外中断。

相关推荐