SqlConnection.ConnectionTimeout Propriété

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Obtient la durée d'attente préalable à l'établissement d'une connexion avant que la tentative ne soit abandonnée et qu'une erreur ne soit générée.

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

public override int ConnectionTimeout { get; }

member this.ConnectionTimeout : int

Public Overrides 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.

Exceptions

ArgumentException

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

Exemples

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

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

Remarques

Vous pouvez définir la durée d’attente d’une connexion à l’aide des Connect Timeout mots clés ou Connection Timeout dans la 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.