SqlConnection.ConnectionTimeout Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Data.SqlClient

Zestaw:: System.Data.SqlClient.dll

Zestaw:: System.Data.dll

Pakiet:: System.Data.SqlClient v4.8.6

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera czas oczekiwania (w sekundach) podczas próby nawiązania połączenia przed zakończeniem próby i wygenerowaniem błędu.

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

Wartość właściwości

Int32

Czas oczekiwania na otwarcie połączenia (w sekundach). Wartość domyślna to 15 sekund.

Implementuje

ConnectionTimeout

Atrybuty: DataSysDescriptionAttribute

Wyjątki

ArgumentException

Zestaw wartości jest mniejszy niż 0.

Przykłady

Poniższy przykład tworzy element SqlConnection i ustawia wartość Connection Timeout na 30 sekund w parametry połączenia. Kod otwiera połączenie i wyświetla ConnectionTimeout właściwość w oknie konsoli.

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

Uwagi

Możesz ustawić czas oczekiwania połączenia na przekroczenie limitu czasu przy użyciu Connect Timeout słów kluczowych lub Connection Timeout w parametry połączenia. Wartość 0 wskazuje brak limitu i należy go uniknąć, ConnectionString ponieważ próba połączenia czeka na czas nieokreślony.

Dotyczy