Freigeben über

SqlConnection.ConnectionTimeout Eigenschaft

  • Referenz

Definition

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Assemblys:
netstandard.dll, System.Data.SqlClient.dll
Paket:
System.Data.SqlClient v4.8.6

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

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

Eigenschaftswert

Int32

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

Implementiert

ConnectionTimeout
Attribute
DataSysDescriptionAttribute

Ausnahmen

ArgumentException

Der festgelegte Wert ist kleiner als 0.

Beispiele

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

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

Hinweise

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

Gilt für:

Weitere Informationen