SqlConnection Constructeurs

  • Référence

Définition

Espace de noms:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Paquet:
System.Data.SqlClient v4.8.6

Initialise une nouvelle instance de la classe SqlConnection.

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.

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

Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()
    Using connection As New SqlConnection(connectionString)
        connection.Open()
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion)
        Console.WriteLine("State: {0}", connection.State)
    End Using
End Sub

Private Function GetConnectionString() As String
    ' 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);Database=AdventureWorks;" _
      & "Integrated Security=SSPI;"
End Function

Remarques

Lorsqu’une nouvelle instance de 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 SqlConnection 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.

Voir aussi

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 System.Data.SqlClient.SqlConnection : string -> System.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

Échec de la validation de l’argument ConnectionString chaîne de connexion fourni.

Exemples

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

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

Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()

    Using connection As New SqlConnection(connectionString)

        connection.Open()

        Console.WriteLine("State: {0}", connection.State)
        Console.WriteLine("ConnectionString: {0}", _
            connection.ConnectionString)
    End Using
End Sub

Private Function GetConnectionString() As String
    ' 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);Database=AdventureWorks;" _
      & "Integrated Security=SSPI;"
End Function

Remarques

Lorsqu’une nouvelle instance de 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 SqlConnection 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.

Voir aussi

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, System::Data::SqlClient::SqlCredential ^ credential);
public SqlConnection (string connectionString, System.Data.SqlClient.SqlCredential credential);
new System.Data.SqlClient.SqlConnection : string * System.Data.SqlClient.SqlCredential -> System.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

Échec de la validation de l’argument ConnectionString chaîne de connexion fourni.

Voir aussi

S’applique à