Partager via


SqlConnection Constructeurs

Définition

Surcharges

SqlConnection()

Initialise une nouvelle instance de la classe SqlConnection.

SqlConnection(String)

Initialise une nouvelle instance de la classe SqlConnection pendant la réception d’une chaîne contenant une chaîne de connexion.

SqlConnection(String, SqlCredential)

Initialise une nouvelle instance de la classe SqlConnection en fonction d’une chaîne de connexion, qui n’utilise pas Integrated Security = true et un objet SqlCredential qui contient l’ID d’utilisateur et le mot de passe.

SqlConnection()

Initialise une nouvelle instance de la classe SqlConnection.

public:
 SqlConnection();
public SqlConnection ();
Public Sub New ()

Exemples

L’exemple suivant crée et ouvre un SqlConnection.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        OpenSqlConnection();
        Console.ReadLine();
    }

    private static void OpenSqlConnection()
    {
        string connectionString = GetConnectionString();
        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.ConfigurationManager.ConnectionStrings property 
        return "Data Source=(local);Initial Catalog=AdventureWorks;"
            + "Integrated Security=SSPI;";
    }
}

Remarques

Lorsqu’une nouvelle instance de SqlConnection est créée, les propriétés en lecture/écriture sont définies sur les valeurs initiales suivantes, sauf si elles sont spécifiquement définies à l’aide de leurs mots clés associés dans la ConnectionString propriété .

Propriétés Valeur initiale
ConnectionString chaîne vide («  »)
ConnectionTimeout 15
Database chaîne vide («  »)
DataSource chaîne vide («  »)

Vous pouvez modifier la valeur de ces propriétés uniquement à l’aide de la ConnectionString propriété . La SqlConnectionStringBuilder classe fournit des fonctionnalités pour créer et gérer le contenu des chaînes de connexion.

S’applique à

SqlConnection(String)

Initialise une nouvelle instance de la classe SqlConnection pendant la réception d’une chaîne contenant une chaîne de connexion.

public:
 SqlConnection(System::String ^ connectionString);
public SqlConnection (string connectionString);
new Microsoft.Data.SqlClient.SqlConnection : string -> Microsoft.Data.SqlClient.SqlConnection
Public Sub New (connectionString As String)

Paramètres

connectionString
String

Connexion utilisée pour ouvrir la base de données SQL Server.

Exceptions

La validation de l’argument de chaîne de connexion fourni a échoué ConnectionString .

Exemples

L’exemple suivant crée et ouvre un SqlConnection.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        OpenSqlConnection();
        Console.ReadLine();
    }

    private static void OpenSqlConnection()
    {
        string connectionString = GetConnectionString();

        using (SqlConnection connection = new SqlConnection(connectionString))
        {
            connection.Open();

            Console.WriteLine("State: {0}", connection.State);
            Console.WriteLine("ConnectionString: {0}",
                connection.ConnectionString);
        }
    }

    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

Lorsqu’une nouvelle instance de SqlConnection est créée, les propriétés en lecture/écriture sont définies sur les valeurs initiales suivantes, sauf si elles sont spécifiquement définies à l’aide de leurs mots clés associés dans la ConnectionString propriété .

Propriétés Valeur initiale
ConnectionString connectionString
ConnectionTimeout 15
Database chaîne vide («  »)
DataSource chaîne vide («  »)

Vous pouvez modifier la valeur de ces propriétés uniquement à l’aide de la ConnectionString propriété . La SqlConnection classe fournit des fonctionnalités pour créer et gérer le contenu des chaînes de connexion.

S’applique à

SqlConnection(String, SqlCredential)

Initialise une nouvelle instance de la classe SqlConnection en fonction d’une chaîne de connexion, qui n’utilise pas Integrated Security = true et un objet SqlCredential qui contient l’ID d’utilisateur et le mot de passe.

public:
 SqlConnection(System::String ^ connectionString, Microsoft::Data::SqlClient::SqlCredential ^ credential);
public SqlConnection (string connectionString, Microsoft.Data.SqlClient.SqlCredential credential);
new Microsoft.Data.SqlClient.SqlConnection : string * Microsoft.Data.SqlClient.SqlCredential -> Microsoft.Data.SqlClient.SqlConnection
Public Sub New (connectionString As String, credential As SqlCredential)

Paramètres

connectionString
String

Chaîne de connexion qui n’utilise aucun des mots clés de chaîne de connexion suivants : Integrated Security = true, UserId ou Password ; ou qui n’utilise pas ContextConnection = true.

credential
SqlCredential

Objet SqlCredential. Si credential est null, SqlConnection(String, SqlCredential) est fonctionnellement équivalent à SqlConnection(String).

Exceptions

La validation des arguments fournis a échoué, y compris ConnectionString la validation.

S’applique à