SqlConnection.ConnectionTimeout Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die Wartezeit (in Sekunden) ab, während versucht wird, eine Verbindung herzustellen, bevor 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 : intPublic Overrides ReadOnly Property ConnectionTimeout As IntegerPublic ReadOnly Property ConnectionTimeout As IntegerEigenschaftswert
Die Zeit (in Sekunden), bis eine Verbindung geöffnet wird. Der Standardwert ist 15 Sekunden.
Implementiert
- Attribute
Ausnahmen
Der Wertsatz ist kleiner als 0.
Beispiele
Im folgenden Beispiel wird eine SqlConnection und die 30 Sekunden in der Verbindungszeichenfolge festgelegt Connection Timeout . 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 mit einem Timeout wartet, indem Sie die Connect Timeout Schlüsselwörter Connection Timeout in der Verbindungszeichenfolge verwenden. Ein Wert von 0 gibt keinen Grenzwert an und sollte in einem ConnectionString Fehler vermieden werden, da ein Versuch, eine Verbindung herzustellen, auf unbestimmte Zeit wartet.
