SqlConnection.ConnectionTimeout Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene el tiempo de espera (en segundos) al intentar establecer una conexión antes de finalizar el intento y generar un error.
public:
virtual property int ConnectionTimeout { int get(); };
public:
property int ConnectionTimeout { int get(); };
public override int ConnectionTimeout { get; }
[System.Data.DataSysDescription("SqlConnection_ConnectionTimeout")]
public int ConnectionTimeout { get; }
member this.ConnectionTimeout : int
[<System.Data.DataSysDescription("SqlConnection_ConnectionTimeout")>]
member this.ConnectionTimeout : int
Public Overrides ReadOnly Property ConnectionTimeout As Integer
Public ReadOnly Property ConnectionTimeout As Integer
Valor de propiedad
El tiempo (en segundos) para esperar a que se abra una conexión. El valor predeterminado es de 15 segundos.
Implementaciones
- Atributos
Excepciones
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.
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 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 conectar esperas indefinidamente.