Sdílet prostřednictvím

SqlConnection.ConnectionTimeout Vlastnost

  • Reference

Definice

Obor názvů:
System.Data.SqlClient
Sestavení:
System.Data.SqlClient.dll
Sestavení:
System.Data.dll
Balíček:
System.Data.SqlClient v4.8.6

Získá čas čekání (v sekundách) při pokusu o navázání připojení před ukončením pokusu a generování chyby.

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

Hodnota vlastnosti

Int32

Doba čekání na otevření připojení (v sekundách). Výchozí hodnota je 15 sekund.

Implementuje

ConnectionTimeout
Atributy
DataSysDescriptionAttribute

Výjimky

ArgumentException

Sada hodnot je menší než 0.

Příklady

Následující příklad vytvoří SqlConnection a nastaví Connection Timeout na 30 sekund v připojovací řetězec. Kód otevře připojení a zobrazí ConnectionTimeout vlastnost v okně konzoly.

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

Poznámky

Dobu, po kterou připojení čeká na vypršení časového limituConnect Timeout, můžete nastavit pomocí klíčových slov nebo Connection Timeout v připojovací řetězec. Hodnota 0 značí žádné omezení, a proto byste se měli v objektu ConnectionString vyhnout, protože pokus o připojení čeká neomezeně dlouho.

Platí pro

Viz také