SqlConnection.Open Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é.