SqlConnectionStringBuilder.ConnectTimeout Eigenschaft

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Ruft die Zeit in Sekunden ab, die auf eine Verbindung zum Server gewartet werden soll, bevor der Versuch abgebrochen und ein Fehler generiert wird, oder legt diesen Wert fest.

public:
 property int ConnectTimeout { int get(); void set(int value); };

public int ConnectTimeout { get; set; }

member this.ConnectTimeout : int with get, set

Public Property ConnectTimeout As Integer

Eigenschaftswert

Int32

Der Wert der ConnectTimeout-Eigenschaft oder 15 Sekunden, wenn kein Wert angegeben wurde.

Beispiele

Im folgenden Beispiel wird zuerst der Inhalt einer Verbindungszeichenfolge angezeigt, in der nicht der "Connect Timeout"-Wert angegeben wird. Anschließend wird die ConnectTimeout-Eigenschaft festgelegt und die neue Verbindungszeichenfolge angezeigt.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Server=(local);Initial Catalog=AdventureWorks;" +
                "Integrated Security=true";
            SqlConnectionStringBuilder builder =
                new SqlConnectionStringBuilder(connectString);
            Console.WriteLine("Original: " + builder.ConnectionString);
            Console.WriteLine("ConnectTimeout={0}",
                builder.ConnectTimeout);
            builder.ConnectTimeout = 100;
            Console.WriteLine("Modified: " + builder.ConnectionString);

            Console.WriteLine("Press any key to finish.");
            Console.ReadLine();

        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
    }
}

Hinweise

Diese Eigenschaft entspricht den Schlüsseln "Connect Timeout", "connection timeout" und "timeout" in der Verbindungszeichenfolge.

Wenn Sie eine Verbindung mit einer Azure SQL-Datenbank herstellen, legen Sie das Verbindungstimeout auf 30 Sekunden fest.

Gültige Werte sind größer oder gleich 0 und kleiner oder gleich 2147483647.