Partager via

SqlConnection Constructeurs

Définition

Espace de noms:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll

Initialise une nouvelle instance de la classe SqlConnection.

Surcharges

Nom Description
SqlConnection()

Initialise une nouvelle instance de la classe SqlConnection.
SqlConnection(String)

Initialise une nouvelle instance de la SqlConnection classe en fonction d’une chaîne qui contient la chaîne de connexion.
SqlConnection(String, SqlCredential)

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

SqlConnection()

Source:
System.Data.SqlClient.notsupported.cs

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 est SqlConnection créée, les propriétés de 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 permettant de créer et de gérer le contenu des chaînes de connexion.

Voir aussi

S’applique à

SqlConnection(String)

Source:
System.Data.SqlClient.notsupported.cs

Initialise une nouvelle instance de la SqlConnection classe en fonction d’une chaîne qui contient la 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 de 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 est SqlConnection créée, les propriétés de 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 permettant de créer et de gérer le contenu des chaînes de connexion.

Voir aussi

S’applique à

SqlConnection(String, SqlCredential)

Source:
System.Data.SqlClient.notsupported.cs

Initialise une nouvelle instance de la SqlConnection classe en fonction d’une chaîne de connexion, qui n’utilise Integrated Security = true pas et un SqlCredential objet qui contient l’ID 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, UserIdou Password; ou qui n’utilise ContextConnection = truepas .

credential
SqlCredential

Objet SqlCredential. Si credential la valeur est Null, SqlConnection(String, SqlCredential) est fonctionnellement équivalente à SqlConnection(String).

Exceptions

ArgumentException

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

Voir aussi

S’applique à