SqlConnection.ConnectionTimeout Propriedade

Definição

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v5.2.0

Obtém o tempo de espera durante a tentativa de estabelecimento da conexão antes que a tentativa seja terminada e um erro seja gerado.

public:
 virtual property int ConnectionTimeout { int get(); };

public override int ConnectionTimeout { get; }

member this.ConnectionTimeout : int

Public Overrides ReadOnly Property ConnectionTimeout As Integer

Valor da propriedade

Int32

O tempo (em segundos) de espera para abrir uma conexão. O valor padrão é 15 segundos.

Exceções

ArgumentException

O valor definido é menor que 0.

Exemplos

O exemplo a seguir cria um SqlConnection e define o Connection Timeout como 30 segundos na cadeia de conexão. O código abre a conexão e exibe a ConnectionTimeout propriedade na janela do console.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        OpenSqlConnection();
        Console.ReadLine();
    }

    private static void OpenSqlConnection()
    {
        string connectionString = GetConnectionString();
        using (SqlConnection connection = new SqlConnection(connectionString))
        {
            connection.Open();
            Console.WriteLine("State: {0}", connection.State);
            Console.WriteLine("ConnectionTimeout: {0}",
                connection.ConnectionTimeout);
        }
    }

    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code, 
        // you can retrieve it from a configuration file, using the 
        // System.Configuration.ConfigurationSettings.AppSettings property 
        return "Data Source=(local);Initial Catalog=AdventureWorks;"
            + "Integrated Security=SSPI;Connection Timeout=30";
    }
}

Comentários

Você pode definir a quantidade de tempo que uma conexão aguarda para atingir o tempo limite usando as Connect Timeout palavras-chave ou Connection Timeout na cadeia de conexão. Um valor de 0 não indica nenhum limite e deve ser evitado em um ConnectionString porque uma tentativa de conexão aguarda indefinidamente.