137

I need to specifically catch SQL server timeout exceptions so that they can be handled differently. I know I could catch the SqlException and then check if the message string Contains "Timeout" but was wondering if there is a better way to do it?

try
{
    //some code
}
catch (SqlException ex)
{

    if (ex.Message.Contains("Timeout"))
    {
         //handle timeout
    }
    else
    {
         throw;
    }
}
2
  • Are you looking for a ConnectionTimeout or a CommandTimeout, ie are you expecting the connection to fail or the executed command to fail?
    – edosoft
    Sep 15, 2008 at 12:49
  • I'm looking for a CommandTimeout, which is set to a default of 30 secs i think
    – brodie
    Sep 15, 2008 at 23:14

6 Answers 6

185

To check for a timeout, I believe you check the value of ex.Number. If it is -2, then you have a timeout situation.

-2 is the error code for timeout, returned from DBNETLIB, the MDAC driver for SQL Server. This can be seen by downloading Reflector, and looking under System.Data.SqlClient.TdsEnums for TIMEOUT_EXPIRED.

Your code would read:

if (ex.Number == -2)
{
     //handle timeout
}

Code to demonstrate failure:

try
{
    SqlConnection sql = new SqlConnection(@"Network Library=DBMSSOCN;Data Source=YourServer,1433;Initial Catalog=YourDB;Integrated Security=SSPI;");
    sql.Open();

    SqlCommand cmd = sql.CreateCommand();
    cmd.CommandText = "DECLARE @i int WHILE EXISTS (SELECT 1 from sysobjects) BEGIN SELECT @i = 1 END";
    cmd.ExecuteNonQuery(); // This line will timeout.

    cmd.Dispose();
    sql.Close();
}
catch (SqlException ex)
{
    if (ex.Number == -2) {
        Console.WriteLine ("Timeout occurred");
    }
}
5
  • Yes, that's pretty much what I'm doing at the moment, but it's not very elegant checking for -2
    – brodie
    Sep 15, 2008 at 23:20
  • 12
    Download Red Gate's Reflector, and search for TIMEOUT_EXPIRED. It lives in System.Data.SqlClient.TdsEnums, and its value is -2. :o)
    – Jonathan
    Sep 18, 2008 at 8:14
  • 2
    For those who do not have access to Reflector: link
    – ankitk
    Nov 14, 2013 at 18:48
  • 6
    @brodie That's why you should make a constant for it and you can explain where the "magic" value came from in a comment on the constant.
    – Jason L.
    Mar 27, 2017 at 18:35
  • The error numbers are documented here: learn.microsoft.com/en-us/sql/relational-databases/… (it is -2 for execution timeout) Sep 22, 2022 at 3:54
26

Updated for c# 6:

    try
    {
        // some code
    }
    catch (SqlException ex) when (ex.Number == -2)  // -2 is a sql timeout
    {
        // handle timeout
    }

Very simple and nice to look at!!

1
  • Thanks... I like your suggestion and use it.
    – Rubens
    Feb 19, 2021 at 19:35
24

here: http://www.tech-archive.net/Archive/DotNet/microsoft.public.dotnet.framework.adonet/2006-10/msg00064.html

You can read also that Thomas Weingartner wrote:

Timeout: SqlException.Number == -2 (This is an ADO.NET error code)
General Network Error: SqlException.Number == 11
Deadlock: SqlException.Number == 1205 (This is an SQL Server error code)

...

We handle the "General Network Error" as a timeout exception too. It only occurs under rare circumstances e.g. when your update/insert/delete query will raise a long running trigger.

0

Whats the value for the SqlException.ErrorCode property? Can you work with that?

When having timeouts, it may be worth checking the code for -2146232060.

I would set this up as a static const in your data code.

2
  • 2
    Looking at the docs for ErrorCode, it seems to me that it's reporting Interop-Level errors. So it may be more on the level of COM errors or that a provider encountered an exception (generally) instead of a specific error relating to what you're doing. Jun 18, 2010 at 18:23
  • @Eric is correct - that is an HRESULT code for the SqlException type, not for the source of the exception.
    – codekaizen
    Dec 16, 2011 at 23:56
0

I am not sure but when we have execute time out or command time out The client sends an "ABORT" to SQL Server then simply abandons the query processing. No transaction is rolled back, no locks are released. to solve this problem I Remove transaction in Stored-procedure and use SQL Transaction in my .Net Code To manage sqlException

-2

When a client sends ABORT, no transactions are rolled back. To avoid this behavior we have to use SET_XACT_ABORT ON https://learn.microsoft.com/en-us/sql/t-sql/statements/set-xact-abort-transact-sql?view=sql-server-ver15

1
  • 1
    It does not answer the question which is how to catch a command timeout in the c# code
    – Jonathan
    Nov 13, 2019 at 20:22

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.