SqlConnection.ConnectionString Propriété

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

public:
 property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

public override string ConnectionString { get; set; }

[System.Data.DataSysDescription("SqlConnection_ConnectionString")]
public string ConnectionString { get; set; }

[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }

member this.ConnectionString : string with get, set

[<System.Data.DataSysDescription("SqlConnection_ConnectionString")>]
member this.ConnectionString : string with get, set

[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set

Public Overrides Property ConnectionString As String

Public Property ConnectionString As String

Valeur de propriété

Chaîne de connexion comportant le nom de la base de données source et d'autres paramètres nécessaires à l'établissement de la connexion initiale. La valeur par défaut est une chaîne vide.

Implémente

Attributs

DataSysDescriptionAttribute SettingsBindableAttribute

Exceptions

Exemples

L’exemple suivant crée un SqlConnection et définit la ConnectionString propriété avant d’ouvrir la connexion.

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

    using (SqlConnection connection = new SqlConnection())
    {
        connection.ConnectionString = 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.
    return "Data Source=MSSQL1;Initial Catalog=AdventureWorks;"
        + "Integrated Security=true;";
}

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

    Using connection As New SqlConnection()

        connection.ConnectionString = 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.
    Return "Data Source=MSSQL1;Database=AdventureWorks;" _
      & "Integrated Security=true;"
End Function

Remarques

Le ConnectionString est similaire à un chaîne de connexion OLE DB, mais n’est pas identique. Contrairement à OLE DB ou ADO, le chaîne de connexion retourné est identique au jeu ConnectionStringd’utilisateurs , moins les informations de sécurité si la valeur Persist Security Info est définie sur false (par défaut). Le fournisseur de données .NET Framework pour SQL Server ne conserve pas ou ne retourne pas le mot de passe dans un chaîne de connexion, sauf si vous définissez Persist Security Info sur true.

Vous pouvez utiliser la ConnectionString propriété pour vous connecter à une base de données. L’exemple suivant illustre une chaîne de connexion classique.

"Persist Security Info=False;Integrated Security=true;Initial Catalog=Northwind;server=(local)"

Utilisez le nouveau SqlConnectionStringBuilder pour construire des chaînes de connexion valides au moment de l’exécution. Pour plus d’informations, consultez Builders de chaînes de connexion.

La ConnectionString propriété peut être définie uniquement lorsque la connexion est fermée. La plupart des valeurs chaîne de connexion ont des propriétés en lecture seule correspondantes. Lorsque le chaîne de connexion est défini, ces propriétés sont mises à jour, sauf lorsqu’une erreur est détectée. Dans ce cas, aucune des propriétés n’est mise à jour. SqlConnection les propriétés retournent uniquement les paramètres contenus dans le ConnectionString.

Pour vous connecter à un ordinateur local, spécifiez « (local) » pour le serveur. Si aucun nom de serveur n’est spécifié, une connexion est tentée avec le instance par défaut sur l’ordinateur local.

La réinitialisation de sur ConnectionString une connexion fermée réinitialise toutes les valeurs chaîne de connexion (et les propriétés associées), y compris le mot de passe. Par exemple, si vous définissez un chaîne de connexion qui inclut « Database= AdventureWorks », puis réinitialisez le chaîne de connexion sur « Source de données =myserver ; Integrated Security=true », la Database propriété n’est plus définie sur « AdventureWorks ».

Le chaîne de connexion est analysé immédiatement après avoir été défini. Si des erreurs de syntaxe sont détectées lors de l’analyse, une exception d’exécution, telle que ArgumentException, est générée. D’autres erreurs ne peuvent être trouvées que lorsqu’une tentative d’ouverture de la connexion est effectuée.

Le format de base d’un chaîne de connexion comprend une série de paires mot clé/valeur séparées par des points-virgules. Le signe égal (=) sert de lien entre chaque mot clé et sa valeur. Pour inclure des valeurs qui contiennent un point-virgule, un guillemet simple ou un guillemet double, la valeur doit être placée entre guillemets doubles. Si la valeur contient à la fois un point-virgule et un guillemet double, la valeur peut être placée entre guillemets simples. Le guillemet simple est également utile si la valeur commence par un guillemet double. À l’inverse, le guillemet double peut être utilisé si la valeur commence par un guillemet unique. Si la valeur contient à la fois des guillemets simples et des guillemets doubles, le caractère de guillemet utilisé pour entourer la valeur doit être doublé chaque fois qu’il se produit dans la valeur.

Pour inclure des espaces précédents ou de fin dans la valeur de chaîne, la valeur doit être placée entre guillemets simples ou guillemets doubles. Tous les espaces de début ou de fin autour des valeurs entières, booléennes ou énumérées sont ignorés, même s’ils sont placés entre guillemets. Toutefois, les espaces dans un littéral de chaîne mot clé ou une valeur sont conservés. Des guillemets simples ou doubles peuvent être utilisés dans un chaîne de connexion sans utiliser de délimiteurs (par exemple, Data Source= my’Server ou Data Source= my"Server), sauf si un guillemet est le premier ou le dernier caractère de la valeur.

Les mots clés ne respectent pas la casse.

Le tableau suivant répertorie les noms valides pour les valeurs mot clé dans le ConnectionString.

La liste suivante contient les noms valides pour les valeurs de regroupement de connexions dans le ConnectionString. Pour plus d’informations, consultez Regroupement de connexions SQL Server (ADO.NET).

• Durée de vie de la connexion (ou délai d’expiration de l’équilibre de charge)

• Enlist

• Max Pool Size

• Min Pool Size

• Pooling

Lorsque vous définissez des valeurs de regroupement de mot clé ou de connexions qui nécessitent une valeur booléenne, vous pouvez utiliser « yes » au lieu de « true » et « no » au lieu de « false ». Les valeurs entières sont représentées sous forme de chaînes.

S’applique à

Voir aussi

• Fournisseurs managés ADO.NET et centre de développement DataSet
• Chaînes de connexion dans ADO.NET
• Regroupement de connexions SQL Server (ADO.NET)
• Connexion à une source de données dans ADO.NET
• Vue d'ensemble d’ADO.NET