SqlConnection.Open Méthode

Définition

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

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

Implémente

Exceptions

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

ou

La connexion est déjà ouverte.

Une erreur de connexion s’est produite lors de l’ouverture de la connexion. Si la propriété Number 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 méthode ChangePassword(String, String) .

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

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

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 établit une connexion ouverte à partir du pool de connexions, le cas échéant. Sinon, il établit une nouvelle connexion à un instance de SQL Server.

Notes

Si le SqlConnection sort de l’étendue, il n’est pas fermé. Par conséquent, vous devez fermer explicitement la connexion en appelant Close.

Notes

Si vous spécifiez un numéro de port autre que 1433 lorsque vous essayez de vous connecter à un instance de SQL Server et à l’aide d’un protocole autre que TCP/IP, la Open méthode é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.

Notes

Le fournisseur de données .NET Framework pour SQL Server nécessite l’autorisation Sécurité avec « Autorise les appels aux assemblys non managés » activé (SecurityPermissionavec SecurityPermissionFlag la valeur définie sur UnmanagedCode) pour ouvrir un SqlConnection avec débogage SQL activé.

S’applique à

Voir aussi