SqlConnection.ConnectionTimeout Propiedad

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v5.2.0

Obtiene el tiempo de espera para intentar establecer una conexión antes de detenerse y generar un error.

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

public override int ConnectionTimeout { get; }

member this.ConnectionTimeout : int

Public Overrides ReadOnly Property ConnectionTimeout As Integer

Valor de propiedad

Int32

El tiempo (en segundos) que se debe esperar para que se abra una conexión. El valor predeterminado es 15 segundos.

Excepciones

ArgumentException

El valor establecido es menor que 0.

Ejemplos

En el ejemplo siguiente se crea y SqlConnection se establece en Connection Timeout 30 segundos en la cadena de conexión. El código abre la conexión y muestra la ConnectionTimeout propiedad en la ventana de la consola.

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";
    }
}

Comentarios

Puede establecer la cantidad de tiempo que espera una conexión para agotar el tiempo de espera mediante las Connect Timeout palabras clave o Connection Timeout de la cadena de conexión. Un valor de 0 indica que no hay límite y debe evitarse en porque ConnectionString un intento de conexión espera indefinidamente.