SqlConnection.Open Méthode

Définition

Espace de noms:
System.Data.SqlClient
Assembly:
System.Data.dll

Ouvre une connexion de base de données avec les paramètres de propriété spécifiés par le ConnectionString.

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

Implémente

Open()

Exceptions

InvalidOperationException

Impossible d’ouvrir une connexion sans spécifier de source de données ou de serveur.

ou

La connexion est déjà ouverte.

SqlException

Une erreur au niveau de la connexion s’est produite lors de l’ouverture de la connexion. Si la Number propriété contient la valeur 18487 ou 18488, cela indique que le mot de passe spécifié a expiré ou doit être réinitialisé. Pour plus d’informations, consultez la ChangePassword(String, String) méthode.

La <system.data.localdb> balise dans le fichier app.config a des éléments non valides ou inconnus.

ConfigurationErrorsException

Il existe deux entrées portant le même nom dans la <localdbinstances> section.

Exemples

L’exemple suivant crée un SqlConnection, l’ouvre et affiche certaines de ses propriétés. La connexion est automatiquement fermée à 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

Le SqlConnection dessine une connexion ouverte à partir du pool de connexions si une connexion est disponible. Sinon, il établit une nouvelle connexion à une instance de SQL Server.

Note

Si la SqlConnection portée est hors de portée, elle n’est pas fermée. Par conséquent, vous devez fermer explicitement la connexion en appelant Close.

Note

Si vous spécifiez un numéro de port autre que 1433 lorsque vous essayez de vous connecter à une instance de SQL Server et à l’aide d’un protocole autre que TCP/IP, la méthode Open échoue. Pour spécifier un numéro de port autre que 1433, incluez « server=machinename, port number » dans le chaîne de connexion et utilisez le protocole TCP/IP.

Note

Le Fournisseur de données framework .NET pour SQL Server nécessite l’autorisation sécurité avec l’autorisation « Autoriser les appels aux assemblys non managés » activés (SecurityPermission avec SecurityPermissionFlag défini sur UnmanagedCode) pour ouvrir un SqlConnection avec le débogage SQL activé.

S’applique à

Voir aussi