通过

SqlCommand.CommandTimeout 属性

定义

命名空间:
System.Data.SqlClient
程序集:
System.Data.SqlClient.dll
程序集:
System.Data.dll
Source:
System.Data.SqlClient.notsupported.cs

获取或设置在终止尝试执行命令并生成错误之前（以秒为单位）的等待时间。

public:
 virtual property int CommandTimeout { int get(); void set(int value); };
public:
 property int CommandTimeout { int get(); void set(int value); };
public override int CommandTimeout { get; set; }
[System.Data.DataSysDescription("DbCommand_CommandTimeout")]
public int CommandTimeout { get; set; }
member this.CommandTimeout : int with get, set
[<System.Data.DataSysDescription("DbCommand_CommandTimeout")>]
member this.CommandTimeout : int with get, set
Public Overrides Property CommandTimeout As Integer
Public Property CommandTimeout As Integer

属性值

Int32

等待命令执行的时间（以秒为单位）。 默认为 30 秒。

实现

CommandTimeout
属性
DataSysDescriptionAttribute

注解

值为 0 表示没有限制（尝试执行命令将无限期等待）。

注释

旧 APM（异步编程模型）异步方法调用（例如BeginExecuteReader）将忽略该CommandTimeout属性。 它将由较新的 TAP（任务异步编程）方法（如 ExecuteReaderAsync.

CommandTimeout 当命令针对上下文连接执行时不起作用（ SqlConnection 在连接字符串中使用“context connection=true”打开）。

注释

此属性是命令执行或处理结果期间所有网络读取的累积超时（对于在调用方法期间读取的所有网络数据包）。 返回第一行后仍可能发生超时，并且不包括用户处理时间（仅网络读取时间）。

例如，如果使用 30 秒超时，如果需要 Read 两个网络数据包，则读取这两个网络数据包需要 30 秒。 如果再次调用 Read ，它将再有 30 秒来读取它所需的任何数据。

using System;
using System.Data.SqlClient;
///
public class A {
   ///
   public static void Main() {
      string connectionString = "";
      // Wait for 5 second delay in the command
      string queryString = "waitfor delay '00:00:05'";
      using (SqlConnection connection = new SqlConnection(connectionString)) {
         connection.Open();
         SqlCommand command = new SqlCommand(queryString, connection);
         // Setting command timeout to 1 second
         command.CommandTimeout = 1;
         try {
            command.ExecuteNonQuery();
         }
         catch (SqlException e) {
            Console.WriteLine("Got expected SqlException due to command timeout ");
            Console.WriteLine(e);
         }
      }
   }
}

适用于

另请参阅