SqlConnectionStringBuilder.ConnectRetryCount Propriété

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Nombre de tentatives de reconnexion après l’identification de l’échec de connexion inactive. La valeur doit être un entier compris entre 0 et 255. La valeur par défaut pour les points de terminaison non Azure est 1. Pour Azure SQL points de terminaison, la valeur par défaut est 2. À compter de la version 5.x, pour Azure SQL points de terminaison serverless ou à la demande, la valeur par défaut est 5 pour améliorer la réussite de la connexion pour les connexions à un instance inactif ou suspendu. Définissez la valeur sur 0 pour désactiver la reconnexion en cas d’échec de connexion inactive. Une ArgumentException est levée si la valeur n’appartient pas à la plage autorisée.

C#

public int ConnectRetryCount { get; set; }

Valeur de propriété

Int32

Nombre de tentatives de reconnexion après l’identification de l’échec de connexion inactive.

Remarques

Cette propriété correspond à la clé « Nombre de nouvelles tentatives de connexion » dans le SqlConnection chaîne de connexion.

Note

Depuis la version 5.x, la valeur par défaut pour aucun point de terminaison Azure est 1 et pour Azure SQL et Azure Synapse est passée à 2 et 5 pour imporder la récupération sur les points de terminaison Azure à la demande élevée. Il doit être détecté en premier, et Synapse peut être détecté en tant que point de terminaison de base de données Azure SQL standard.

S’applique à