SqlConnection.Close Méthode

Définition

Ferme la connexion à la base de données. C'est la méthode recommandée de fermeture d'une connexion ouverte.

public:
 override void Close();
public:
 virtual void Close();
public override void Close ();
public void Close ();
override this.Close : unit -> unit
abstract member Close : unit -> unit
override this.Close : unit -> unit
Public Overrides Sub Close ()
Public Sub Close ()

Implémente

Exceptions

Erreur de connexion qui s’est produite lors de l’établissement de la connexion.

Exemples

L’exemple suivant crée un SqlConnection , l’ouvre et affiche certaines de ses propriétés. La connexion est fermée automatiquement à la fin du using bloc.

private static void OpenSqlConnection(string connectionString)
{
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion);
        Console.WriteLine("State: {0}", connection.State);
    }
}
Private Sub OpenSqlConnection(ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        connection.Open()
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion)
        Console.WriteLine("State: {0}", connection.State)
    End Using
End Sub

Remarques

La Close méthode restaure toutes les transactions en attente. Il libère ensuite la connexion au pool de connexions ou ferme la connexion si le regroupement de connexions est désactivé.

Notes

Les transactions en attente démarrées à l’aide de Transact-SQL ou BeginTransaction sont automatiquement restaurées lorsque la connexion est réinitialisée si le regroupement de connexions est activé. Si le regroupement de connexions est désactivé, la transaction est restaurée après l' SqlConnection.Close appel de. Les transactions démarrées par System.Transactions sont contrôlées via l' System.Transactions infrastructure et ne sont pas affectées par SqlConnection.Close .

Une application peut appeler Close plusieurs fois. Aucune exception n’est générée.

Si le est SqlConnection hors de portée, il ne sera pas fermé. Par conséquent, vous devez fermer explicitement la connexion en appelant Close ou Dispose . Close et Dispose sont fonctionnellement équivalents. Si la valeur Pooling de regroupement de connexions est définie true sur ou yes , la connexion sous-jacente est retournée au pool de connexions. En revanche, si a la Pooling valeur false ou no , la connexion sous-jacente au serveur est fermée.

Notes

Les événements de connexion et de déconnexion ne seront pas déclenchés sur le serveur si une connexion est récupérée depuis le pool de connexions ou qu’elle est retournée au pool, car elle n’est pas réellement fermée lorsqu’elle est retournée au pool. Pour plus d’informations, consultez Regroupement de connexions SQL Server (ADO.NET).

Attention

N’appelez pas Close ou Dispose sur une connexion, un DataReader ou tout autre objet managé dans la Finalize méthode de votre classe. Dans un finaliseur, vous ne devez libérer que les ressources non managées que votre classe possède directement. Si votre classe ne possède pas de ressource non managée, n'incluez pas une méthode Finalize dans la définition de classe. Pour plus d’informations, consultez Nettoyage de la mémoire.

S’applique à

Voir aussi