SqlConnectionStringBuilder.ConnectTimeout Propriedade

Definição

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v5.2.0

Obtém ou define o tempo (em segundos) de espera por uma conexão com o servidor antes de finalizar a tentativa e gerar um erro.

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

Valor da propriedade

Int32

O valor da propriedade ConnectTimeout ou 15 segundos se nenhum valor tiver sido fornecido.

Exemplos

O exemplo a seguir primeiro exibe o conteúdo de uma cadeia de conexão que não especifica o valor "Tempo limite de conexão", define a ConnectTimeout propriedade e exibe a nova cadeia de conexão.

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

Comentários

Essa propriedade corresponde às chaves "Tempo limite de conexão", "tempo limite da conexão" e "tempo limite" dentro da cadeia de conexão.

Ao abrir uma conexão com um banco de dados SQL do Azure, defina o tempo limite da conexão como 30 segundos.

Os valores válidos são maiores ou iguais a 0 e menores ou iguais a 2147483647.