SqlConnection.ConnectionTimeout Właściwość

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

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

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

public override int ConnectionTimeout { get; }

member this.ConnectionTimeout : int

Public Overrides 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.

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 parametrach połączenia. Kod otwiera połączenie i wyświetla ConnectionTimeout właściwość w oknie konsoli.

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

Uwagi

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