SqlCommand.CommandTimeout 속성

정의

네임스페이스:

Microsoft.Data.SqlClient

어셈블리:

Microsoft.Data.SqlClient.dll

패키지:

Microsoft.Data.SqlClient v5.2.0

명령 실행을 종료하고 오류를 생성하기 전 대기 시간(초 단위)을 가져오거나 설정합니다. 기본값은 30초입니다.

public:
 virtual property int CommandTimeout { int get(); void set(int value); };

public override int CommandTimeout { get; set; }

member this.CommandTimeout : int with get, set

Public Overrides Property CommandTimeout As Integer

속성 값

Int32

명령이 실행될 때까지 대기하는 시간(초)입니다. 기본값은 30초입니다.

예외

ArgumentException

설정한 값이 0보다 작은 경우

설명

값이 0이면 제한이 없음을 나타냅니다(명령을 실행하려는 시도는 무기한 대기).

참고

속성은 CommandTimeout 와 같은 BeginExecuteReader이전 스타일의 비동기 메서드 호출 중에 무시됩니다. 와 같은 ExecuteReaderAsync최신 비동기 메서드가 적용됩니다.

참고

이 속성은 명령 실행 또는 결과 처리 중 모든 네트워크 읽기에 대한 누적 제한 시간(메서드 호출 중에 읽은 모든 네트워크 패킷의 경우)입니다. 첫 번째 행이 반환된 후에도 시간 제한은 계속 발생할 수 있으며 사용자 처리 시간은 포함하지 않으며 네트워크 읽기 시간만 포함됩니다.

예를 들어 시간 제한 시간이 30초인 경우 두 개의 네트워크 패킷이 필요한 경우 Read 두 네트워크 패킷을 모두 읽는 데 30초가 걸립니다. 다시 호출 Read 하면 필요한 데이터를 읽는 데 30초가 더 걸립니다.

// <Snippet1>
using System;
using Microsoft.Data.SqlClient;

public class A
{
    public static void Main()
    {
        string connectionString = "<Your-connection-string-here>";
        // 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);
            }
        }
    }
}
// </Snippet1>