SqlConnection.ConnectionTimeout Eigenschaft

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Ruft die Zeit ab, die beim Verbindungsaufbau gewartet werden soll, bis der Versuch beendet und ein Fehler generiert wird.

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

public override int ConnectionTimeout { get; }

member this.ConnectionTimeout : int

Public Overrides ReadOnly Property ConnectionTimeout As Integer

Eigenschaftswert

Int32

Der Zeitraum in Sekunden, in dem auf das Öffnen einer Verbindung gewartet werden soll. Der Standardwert ist 15 Sekunden.

Ausnahmen

ArgumentException

Der festgelegte Wert ist kleiner als 0.

Beispiele

Im folgenden Beispiel wird ein SqlConnection erstellt und auf Connection Timeout 30 Sekunden in der Verbindungszeichenfolge festgelegt. Der Code öffnet die Verbindung und zeigt die ConnectionTimeout Eigenschaft im Konsolenfenster an.

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

Hinweise

Sie können festlegen, wie lange eine Verbindung auf ein Timeout wartet, indem Sie die Connect Timeout Schlüsselwörter oder Connection Timeout in der Verbindungszeichenfolge verwenden. Der Wert 0 gibt kein Limit an und sollte in einem ConnectionString vermieden werden, da ein Verbindungsversuch unbegrenzt wartet.