SqlConnection.ConnectionTimeout Vlastnost

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

Získá dobu čekání 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 override int ConnectionTimeout { get; }

member this.ConnectionTimeout : int

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

Výjimky

ArgumentException

Sada hodnot je menší než 0.

Příklady

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

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

Poznámky

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