SqlConnection Constructeurs

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

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.

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

ArgumentException

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.

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

ArgumentException

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