SqlConnection.ConnectionTimeout Propriété

Référence

Définition

Espace de noms:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Paquet:: System.Data.SqlClient v4.8.6

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient le délai d’attente (en secondes) lors de la tentative d’établissement d’une connexion avant de mettre fin à la tentative et de générer une erreur.

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

Valeur de propriété

Int32

Durée d'attente (en secondes) préalable à l'établissement d'une connexion. La valeur par défaut est de 15 secondes.

Implémente

ConnectionTimeout

Attributs: DataSysDescriptionAttribute

Exceptions

ArgumentException

La valeur définie est inférieure à 0.

Exemples

L’exemple suivant crée un SqlConnection et définit sur Connection Timeout 30 secondes dans le chaîne de connexion. Le code ouvre la connexion et affiche la ConnectionTimeout propriété dans la fenêtre de console.

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

Remarques

Vous pouvez définir la durée d’attente d’une connexion pour expirer à l’aide des Connect Timeout mots clés ou Connection Timeout dans le chaîne de connexion. La valeur 0 n’indique aucune limite et doit être évitée dans un ConnectionString , car une tentative de connexion attend indéfiniment.

S’applique à