SqlConnection.Open Méthode

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

Surcharges

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

Open()

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 override void Open ();

override this.Open : unit -> unit

Public Overrides Sub Open ()

Exceptions

InvalidOperationException

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

ou

La connexion est déjà ouverte.

SqlException

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.

ConfigurationErrorsException

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.

using Microsoft.Data.SqlClient;

class Program1
{
    static void Main()
    {
        string s = GetConnectionString();

        OpenSqlConnection(s);
        Console.ReadLine();
    }

    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);
        }
    }

    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code, 
        // you can retrieve it from a configuration file, using the 
        // System.Configuration.ConfigurationSettings.AppSettings property 
        return "Data Source=(local);Initial Catalog=AdventureWorks;"
            + "Integrated Security=SSPI;";
    }
}

Remarques

Le SqlConnection dessine une connexion ouverte à partir du pool de connexions, le cas échéant. Sinon, il établit une nouvelle connexion à une 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 à une 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 la 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é (SecurityPermission avec défini sur UnmanagedCode) pour ouvrir un SqlConnection avec le SecurityPermissionFlag débogage SQL activé.

Open(SqlConnectionOverrides)

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

public:
 void Open(Microsoft::Data::SqlClient::SqlConnectionOverrides overrides);

public void Open (Microsoft.Data.SqlClient.SqlConnectionOverrides overrides);

override this.Open : Microsoft.Data.SqlClient.SqlConnectionOverrides -> unit

Public Sub Open (overrides As SqlConnectionOverrides)

Paramètres

overrides

SqlConnectionOverrides

Options permettant de remplacer le comportement d’ouverture de connexion par défaut.

Exceptions

InvalidOperationException

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

ou

La connexion est déjà ouverte.

SqlException

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.

ConfigurationErrorsException

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.

using Microsoft.Data.SqlClient;

class Program1
{
    static void Main()
    {
        string s = GetConnectionString();

        OpenSqlConnection(s);
        Console.ReadLine();
    }

    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);
        }
    }

    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code, 
        // you can retrieve it from a configuration file, using the 
        // System.Configuration.ConfigurationSettings.AppSettings property 
        return "Data Source=(local);Initial Catalog=AdventureWorks;"
            + "Integrated Security=SSPI;";
    }
}

Remarques

Le SqlConnection dessine une connexion ouverte à partir du pool de connexions, le cas échéant. Sinon, il établit une nouvelle connexion à une instance de SQL Server. Si des remplacements sont spécifiés, la première tentative ouverte applique les remplacements spécifiés à l’action d’ouverture.

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 à une 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 la 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é (SecurityPermission avec défini sur UnmanagedCode) pour ouvrir un SqlConnection avec le SecurityPermissionFlag débogage SQL activé.