SqlConnection.ConnectionTimeout Propiedad

Definición

Obtiene el tiempo de espera (en segundos) mientras se intenta establecer una conexión antes de que se interrumpa el intento y se genere un error.Gets the time to wait (in seconds) while trying to establish a connection before terminating the attempt and generating an error.

public:
 property int ConnectionTimeout { int get(); };
[System.Data.DataSysDescription("SqlConnection_ConnectionTimeout")]
public int ConnectionTimeout { get; }
member this.ConnectionTimeout : int
Public ReadOnly Property ConnectionTimeout As Integer

Valor de propiedad

El tiempo (en segundos) que se debe esperar para que se abra una conexión.The time (in seconds) to wait for a connection to open. El valor predeterminado es 15 segundos.The default value is 15 seconds.

Implementaciones

Atributos

Excepciones

El valor establecido es menor que 0.The value set is less than 0.

Ejemplos

En el ejemplo siguiente se crea un SqlConnection y se establece el Connection Timeout en 30 segundos en la cadena de conexión.The following example creates a SqlConnection and sets the Connection Timeout to 30 seconds in the connection string. El código abre la conexión y muestra la propiedad ConnectionTimeout en la ventana de la consola.The code opens the connection and displays the ConnectionTimeout property in the console window.

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";
}
Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()
    Using connection As New SqlConnection(connectionString)
        connection.Open()

        Console.WriteLine("State: {0}", connection.State)
        Console.WriteLine("ConnectionTimeout: {0}", connection.ConnectionTimeout)
    End Using
End Sub

Private Function GetConnectionString() As String
    ' 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);Database=AdventureWorks;" _
      & "Integrated Security=SSPI;Connection Timeout=30;"
End Function

Comentarios

Puede establecer la cantidad de tiempo que una conexión espera a que se agote el tiempo de espera mediante el Connect Timeout o Connection Timeout palabras clave en la cadena de conexión.You can set the amount of time a connection waits to time out by using the Connect Timeout or Connection Timeout keywords in the connection string. Un valor de 0 indica que no hay límite y debe evitarse en un ConnectionString porque un intento de conexión espera indefinidamente.A value of 0 indicates no limit, and should be avoided in a ConnectionString because an attempt to connect waits indefinitely.

Se aplica a

Consulte también: