SqlConnection.ConnectionString Propriété

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v7.0.1

Obtient ou définit la chaîne utilisée pour ouvrir une base de données SQL Server.

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

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

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

Public Overrides Property ConnectionString As String

Valeur de propriété

String

Chaîne de connexion qui inclut le nom de la base de données source et d’autres paramètres nécessaires pour établir la connexion initiale. La valeur par défaut est une chaîne vide.

Attributs

SettingsBindableAttribute

Exceptions

ArgumentException

Un argument de chaîne de connexion non valide a été fourni ou un argument de chaîne de connexion obligatoire n’a pas été fourni.

Exemples

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

using Microsoft.Data.SqlClient;

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

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

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

using System;
using System.Data;
using Microsoft.Data.SqlClient;

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

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

Remarques

Il ConnectionString est similaire à une chaîne de connexion OLE DB, mais n’est pas identique. Contrairement à OLE DB ou ADO, la chaîne de connexion retournée est la même que l’ensemble ConnectionStringd’utilisateurs, moins les informations de sécurité si la valeur Persist Security Info est définie false sur (valeur 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 une 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, voir constructeurs de chaînes de connexion.

La ConnectionString propriété ne peut être définie que lorsque la connexion est fermée. La plupart des valeurs de chaîne de connexion ont des propriétés en lecture seule correspondantes. Lorsque la chaîne de connexion est définie, 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 un nom de serveur n’est pas spécifié, une connexion est tentée vers l’instance par défaut sur l’ordinateur local.

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

La chaîne de connexion est analysée immédiatement après avoir été définie. Si des erreurs dans la 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 peuvent être trouvées uniquement lorsqu’une tentative d’ouverture de la connexion est effectuée.

Le format de base d’une chaîne de connexion comprend une série de paires mot clé/valeur séparées par des points-virgules. Le signe égal (=) connecte chaque mot clé et sa valeur. Pour inclure des valeurs qui contiennent un point-virgule, un caractère de guillemet unique ou un caractère de guillemets doubles, la valeur doit être placée entre guillemets doubles. Si la valeur contient à la fois un point-virgule et un caractère de guillemets doubles, la valeur peut être placée entre guillemets simples. Le guillemet unique est également utile si la valeur commence par un caractère de 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 guillemet utilisé pour placer la valeur doit être doublé chaque fois qu’elle 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 mot clé littéral de chaîne ou une valeur sont conservés. Des guillemets simples ou doubles peuvent être utilisés dans une chaîne de connexion sans utiliser de délimiteurs (par exemple, source de données = my’Server ou source de données= 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 de mot clé dans le ConnectionString.

Mot clé	Par défaut	Description
Addr	N/A	Synonyme de source de données.
Adresse	N/A	Synonyme de source de données.
App	N/A	Synonyme du nom de l’application.
Intention de l'application - ou - Intention de l'Application	Lecture/écriture	Déclare le type de la charge de travail de l'application lors de la connexion à un serveur. Les valeurs possibles sont ReadOnly et ReadWrite. Par exemple: ApplicationIntent=ReadOnly Pour plus d’informations sur la prise en charge de SqlClient pour les groupes de disponibilité AlwaysOn, consultez Prise en charge de SqlClient pour la haute disponibilité et la récupération d’urgence.
Nom de l’application	N/A	Le nom de la demande. Si aucun nom d'application n'est fourni, « Framework Microsoft SqlClient Fournisseur de données » lors de l'exécution sur .NET Framework et « Core Microsoft SqlClient Fournisseur de données » sinon. Un nom d’application peut comporter 128 caractères ou moins.
AttachDBFilename - ou - Propriétés étendues - ou - Nom de fichier initial	N/A	Nom du fichier de base de données primaire, y compris le nom complet du chemin d’accès d’une base de données pouvant être attachée. AttachDBFilename est pris en charge uniquement pour les fichiers de données principaux avec une extension .mdf. Si la valeur de la clé AttachDBFileName est spécifiée dans la chaîne de connexion, la base de données est attachée et devient la base de données par défaut pour la connexion. Si cette clé n’est pas spécifiée et si la base de données a été précédemment attachée, la base de données ne sera pas attachée. La base de données précédemment attachée sera utilisée comme base de données par défaut pour la connexion. Si cette clé est spécifiée avec la clé AttachDBFileName, la valeur de cette clé sera utilisée comme alias. Toutefois, si le nom est déjà utilisé dans une autre base de données jointe, la connexion échoue. Le chemin d’accès peut être absolu ou relatif à l’aide de la chaîne de substitution DataDirectory. Si DataDirectory est utilisé, le fichier de base de données doit exister dans un sous-répertoire du répertoire vers lequel pointe la chaîne de substitution. Note: Les noms de chemin d’accès à distance, HTTP et UNC ne sont pas pris en charge. Le nom de la base de données doit être spécifié avec le mot clé « database » (ou l’un de ses alias) comme dans les éléments suivants : "AttachDbFileName=|DataDirectory|\data\YourDB.mdf;integrated security=true;database=YourDatabase" Une erreur est générée si un fichier journal existe dans le même répertoire que le fichier de données et que le mot clé « base de données » est utilisé lors de l’attachement du fichier de données principal. Dans ce cas, supprimez le fichier journal. Une fois la base de données jointe, un nouveau fichier journal est généré automatiquement en fonction du chemin d’accès physique.
Protocole d’attestation	NotSpecified	Obtient ou définit la valeur du protocole d’attestation. Lorsqu’aucune valeur n’est spécifiée, les enclaves sécurisées sont désactivées sur la connexion. Les valeurs valides sont les suivantes : AAS HGS None (Valide uniquement dans v3.1 et v4.1+))
Authentication	N/A	Méthode d’authentification utilisée pour Connecting à SQL Database à l’aide de l’authentification Entra ID. Les valeurs valides sont les suivantes : Active Directory Integrated, Active Directory Interactive, Active Directory Password, Active Directory Service Principal, Active Directory Device Code Flow, Active Directory Managed Identity, Active Directory MSI, Active Directory Default, Sql Password. Pour plus d’informations, consultez Utilisant l’authentification Entra ID avec SqlClient.
Paramètre de chiffrement de colonne	handicapé	Active ou désactive la fonctionnalité Always Encrypted pour la connexion. Les valeurs prises en charge sont les suivantes : enabled et disabled
Délai d’expiration de la commande	30	Délai d’attente par défaut (en secondes) avant l’arrêt de la tentative d’exécution d’une commande, et la génération d’une erreur. Les valeurs valides sont supérieures ou égales à 0 et inférieures ou égales à 2147483647.
Nombre de nouvelles tentatives de connexion - ou - ConnectRetryCount	1	Contrôle le nombre de tentatives de reconnexion après que le client identifie un échec de connexion inactif. Les valeurs valides sont comprises entre 0 et 255. 0 signifie ne pas tenter de se reconnecter (désactiver la résilience de connexion). Remarque : Dans la version 5.x, la valeur par défaut pour les points de terminaison non Azure est 1. Pour les points de terminaison Azure SQL, la valeur par défaut est 2. Pour Azure SQL points de terminaison serverless ou à la demande, la valeur par défaut est 5 pour améliorer la réussite de la connexion pour les connexions à une instance inactive ou suspendue. Pour plus d’informations sur la résilience des connexions inactives, consultez .NET paramètres SqlConnection pour la nouvelle tentative de connexion et Exécutance de connexion inactive.
Intervalle avant nouvelle tentative de connexion - ou - ConnectRetryInterval	10	Spécifie le temps entre chaque tentative de nouvelle tentative de connexion (ConnectRetryCount). Les valeurs valides sont de 1 à 60 secondes (valeur par défaut =10), appliquées après la première tentative de reconnexion. Lorsqu’une connexion interrompue est détectée, le client tente immédiatement de se reconnecter ; il s’agit de la première tentative de reconnexion et se produit uniquement si ConnectRetryCount elle est supérieure à 0. Si la première tentative de reconnexion échoue et ConnectRetryCount est supérieure à 1, le client attend ConnectRetryInterval d’essayer la deuxième tentative et les tentatives de reconnexion suivantes. Pour plus d’informations sur la résilience des connexions inactives, consultez.NET paramètres SqlConnection pour la nouvelle tentative de connexion et Exécutance de connexion inactive.
Délai d’expiration de connexion - ou - Délai de connexion - ou - Délai d'expiration	15	Durée d’attente (en secondes) d’une connexion au serveur avant l’arrêt de la tentative, et la génération d’une erreur. Les valeurs valides sont supérieures ou égales à 0 et inférieures ou égales à 2147483647. Lors de l’ouverture d’une connexion à une base de données Azure SQL Database, définissez le délai d’expiration de la connexion sur 30 secondes.
Langue actuelle - ou - Language	N/A	Définit la langue utilisée pour les messages d’avertissement ou d’erreur du serveur de base de données. Le nom de la langue peut comporter 128 caractères ou moins.
Source de données - ou - Serveur - ou - Adresse - ou - Addr - ou - Adresse réseau	N/A	Nom ou adresse réseau de l’instance de SQL Server à laquelle se connecter. Le numéro de port peut être spécifié après le nom du serveur : server=tcp:servername, portnumber Lors de la spécification d’une instance locale, utilisez toujours (local). Pour forcer un protocole, ajoutez l’un des préfixes suivants : np:(local), tcp:(local), lpc:(local) Vous pouvez également vous connecter à une base de données LocalDB comme suit : server=(localdb)\\myInstance Pour plus d’informations sur LocalDB, consultez La prise en charge de SqlClient pour LocalDB. La source de données doit utiliser le format TCP ou le format canaux nommés. Le format TCP est le suivant : - tcp :<host name>\<instance name> - tcp :<host name,TCP></IP port number> Le format TCP doit commencer par le préfixe « tcp : » et est suivi de l’instance de base de données, comme spécifié par un nom d’hôte et un nom d’instance. Ce format n’est pas applicable lors de la connexion à Azure SQL Database. TCP est automatiquement sélectionné pour les connexions à Azure SQL Database lorsqu’aucun protocole n’est spécifié. Le nom d’hôte DOIT être spécifié de l’une des manières suivantes : - NetBIOSName - IPv4Address - IPv6Address Le nom de l’instance est utilisé pour résoudre un numéro de port TCP/IP particulier sur lequel une instance de base de données est hébergée. Vous pouvez également spécifier directement un numéro de port TCP/IP. Si le nom de l’instance et le numéro de port ne sont pas présents, l’instance de base de données par défaut est utilisée. Le format canaux nommés est le suivant : - np :\\<host name>\pipe\<pipe> Le format Canaux nommés DOIT commencer par le préfixe « np : » et est suivi d’un nom de canal nommé. Le nom d’hôte DOIT être spécifié de l’une des manières suivantes : - NetBIOSName - IPv4Address - IPv6Address Le nom du canal est utilisé pour identifier l’instance de base de données à laquelle l’application .NET se connecte. Si la valeur de la clé réseau est spécifiée, les préfixes « tcp : » et « np : » ne doivent pas être spécifiés. Note: Vous pouvez forcer l’utilisation de TCP au lieu de la mémoire partagée, soit en préfixant tcp : sur le nom du serveur dans la chaîne de connexion, soit à l’aide de localhost.
URL d’attestation d’enclave	N/A	Obtient ou définit l’URL d’attestation d’enclave à utiliser avec Always Encrypted basé sur enclave.
Chiffrer	'true' dans la version 4.0 et ultérieures 'false' dans 3.x et ci-dessous	Les valeurs reconnues sont les suivantes : versions 1 - 4 : true/yes et false/no versions 5+ : true/yesmandatory/et . false/no/optionalstrict Quand true, le chiffrement TLS est utilisé pour toutes les données envoyées entre le client et le serveur si le serveur dispose d’un certificat installé. Quand strict, le chiffrement TLS TDS 8.0 est utilisé et le TrustServerCertificate paramètre est ignoré et traité comme false. Pour plus d’informations, consultez Syntaxe de la chaîne de connexion. Lorsque Encrypt est mandatory ou strict et TrustServerCertificate est false, le nom du serveur (ou l'adresse IP) dans le certificat d'un serveur doit correspondre exactement au nom du serveur (ou adresse IP) spécifié dans l'chaîne de connexion. Sinon, la tentative de connexion échoue.
Enrôler	'true'	true indique que le pool de connexions SQL Server inscrit automatiquement la connexion dans le contexte de transaction actuel du thread de création.
Partenaire de basculement	N/A	Nom du serveur partenaire de basculement où la mise en miroir de bases de données est configurée. Si la valeur de cette clé est « », le catalogue initial doit être présent et sa valeur ne doit pas être « ». Le nom du serveur peut comporter 128 caractères ou moins. Si vous spécifiez un partenaire de basculement, mais que le serveur partenaire de basculement n’est pas configuré pour la mise en miroir de bases de données et que le serveur principal (spécifié avec le mot clé serveur) n’est pas disponible, la connexion échoue. Si vous spécifiez un partenaire de basculement et que le serveur principal n’est pas configuré pour la mise en miroir de bases de données, la connexion au serveur principal (spécifiée avec le mot clé serveur) réussit si le serveur principal est disponible.
SPN du partenaire de basculement - ou - FailoverPartnerSPN	N/A	SPN du partenaire de basculement. La valeur par défaut est une chaîne vide, ce qui permet à SqlClient d’utiliser le SPN généré par le pilote par défaut. (Disponible uniquement dans v5.0+)
Nom d’hôte dans le certificat - ou - HostNameInCertificate	N/A	Nom d’hôte à utiliser lors de la validation du certificat de serveur. Lorsqu’il n’est pas spécifié, le nom du serveur de la source de données est utilisé pour la validation de certificat. (Disponible uniquement dans v5.0+)
Certificat de serveur - ou - ServerCertificate	N/A	Chemin d’accès à un fichier de certificat correspondant au certificat TLS/SSL SQL Server. Les formats de certificat acceptés sont PEM, DER et CER. Si spécifié, le certificat SQL Server est vérifié en vérifiant si le ServerCertificate fourni est une correspondance exacte. (Disponible uniquement dans la version 5.1+)
Catalogue initial - ou - Base de données	N/A	Nom de la base de données. Le nom de la base de données peut comporter 128 caractères ou moins.
Sécurité intégrée - ou - Trusted_Connection	'false'	Quand false, l’ID utilisateur et le mot de passe sont spécifiés dans la connexion. Quand true, les informations d’identification de compte Windows actuelles sont utilisées pour l’authentification. Les valeurs reconnues sont true, , falseyes, noet sspi (fortement recommandé), ce qui équivaut à true. Si l’ID d’utilisateur et le mot de passe sont spécifiés et que la sécurité intégrée est définie sur true, l’ID d’utilisateur et le mot de passe sont ignorés et la sécurité intégrée est utilisée. SqlCredential est un moyen plus sécurisé de spécifier des informations d’identification pour une connexion qui utilise l’authentification SQL Server (Integrated Security=false).
Préférence d’adresse IP - ou - IPAddressPreference	IPv4First	Préférence de famille d’adresses IP lors de l’établissement de connexions TCP. Si Transparent Network IP Resolution (dans .NET Framework) ou Multi Subnet Failover a la valeur true, ce paramètre n’a aucun effet. Les valeurs prises en charge sont : IPAddressPreference=IPv4First IPAddressPreference=IPv6First IPAddressPreference=UsePlatformDefault
Délai d’expiration de l’équilibre de charge - ou - Durée de vie de la connexion	0	Lorsqu’une connexion est retournée au pool, l’heure de sa création est comparée à l’heure actuelle et la connexion est détruite si cet intervalle de temps (en secondes) excède la valeur spécifiée par Connection Lifetime. Cela est utile dans les configurations en clusters pour forcer l'équilibrage de la charge entre un serveur en cours d'exécution et un serveur qui vient d'être mis en ligne. La valeur zéro (0) entraîne l’expiration maximale du délai d’expiration des connexions regroupées.
Taille maximale du pool	100	Nombre maximal de connexions autorisées dans le pool. Les valeurs valides sont supérieures ou égales à 1. Les valeurs inférieures à la taille minimale du pool génèrent une erreur.
Taille minimale du pool	0	Nombre minimal de connexions autorisées dans le pool. Les valeurs valides sont supérieures ou égales à 0. Zéro (0) dans ce champ signifie qu’aucune connexion minimale n’est initialement ouverte. Les valeurs supérieures à la taille maximale du pool génèrent une erreur.
Jeux de résultats actifs multiples - ou - MultipleActiveResultSets	faux	Quand true, une application peut gérer plusieurs jeux de résultats actifs (MARS). Quand false, une application doit traiter ou annuler tous les jeux de résultats d’un lot avant de pouvoir exécuter n’importe quel autre lot sur cette connexion. Les valeurs reconnues sont true et false. Pour plus d’informations, consultez Plusieurs jeux de résultats actifs (MARS) .
Basculement de sous-réseau multiple - ou - MultiSubnetFailover	faux	Spécifiez multiSubnetFailover=True toujours lors de la connexion à l’écouteur du groupe de disponibilité d’un groupe de disponibilité SQL Server 2012 (ou version ultérieure) ou d’une instance de cluster de basculement SQL Server 2012 (ou version ultérieure). multiSubnetFailover=True configure SqlClient pour fournir une détection et une connexion plus rapides au serveur actif (actuellement). Les valeurs possibles sont Yes et No, True et False ou 1 et .0 Par exemple: MultiSubnetFailover=True La valeur par défaut est False. Pour plus d’informations sur la prise en charge de SqlClient pour les groupes de disponibilité Always On, consultez La prise en charge de SqlClient pour la haute disponibilité, la récupération d’urgence.
Bibliothèque réseau - ou - Réseau - ou - Net	N/A	Bibliothèque réseau utilisée pour établir une connexion à une instance de SQL Server. Les valeurs prises en charge sont : dbnmpntw (canaux nommés) dbmsrpcn (multiprotocol, Windows RPC) dbmsadsn (Apple Talk) dbmsgnet (VIA) dbmslpcn (mémoire partagée) dbmsspxn (IPX/SPX) dbmssocn (TCP/IP) Dbmsvinn (Banyan Vines) La DLL réseau correspondante doit être installée sur le système auquel vous vous connectez. Si vous ne spécifiez pas de réseau et que vous utilisez un serveur local (par exemple, « » ou « (local) »), la mémoire partagée est utilisée. Dans cet exemple, la bibliothèque réseau est Win32 Winsock TCP/IP (dbmssocn) et 1433 est le port utilisé. Network Library=dbmssocn;Data Source=000.000.000.000,1433;
Taille des paquets	8 000	Taille en octets des paquets réseau utilisés pour communiquer avec une instance de SQL Server. La taille du paquet peut être supérieure ou égale à 512 et inférieure ou égale à 32768.
Mot de passe - ou - PWD	N/A	Mot de passe pour la journalisation du compte SQL Server. Non recommandé. Pour maintenir un niveau de sécurité élevé, nous vous recommandons vivement d’utiliser le mot clé ou Integrated Security le mot clé à la Trusted_Connection place. SqlCredential est un moyen plus sécurisé de spécifier des informations d’identification pour une connexion qui utilise l’authentification SQL Server. Le mot de passe doit comporter 128 caractères ou moins.
Conserver les informations de sécurité - ou - PersistSecurityInfo	'false'	Lorsqu’elles sont définies false sur ou no (fortement recommandées), les informations sensibles à la sécurité, telles que le mot de passe ou le jeton d’accès, ne sont pas retournées dans le cadre de la connexion si la connexion est ouverte ou n’a jamais été dans un état ouvert. Cette propriété ne doit être définie true que si votre application a un besoin spécifique de lire le mot de passe d’une connexion de base de données déjà ouverte. La valeur false par défaut est le paramètre plus sécurisé . L’utilisation true de cette propriété ouvre votre application aux risques de sécurité tels que la journalisation accidentelle ou le suivi du mot de passe de la base de données. La réinitialisation de la chaîne de connexion réinitialise toutes les valeurs de chaîne de connexion, y compris le mot de passe. Les valeurs reconnues sont true, false, yes et no.
Période de blocage du pool - ou - PériodeDeBlocageDuPool	Automatique	Définit le comportement de période de blocage pour un pool de connexions. Pour plus d’informations, consultez PoolBlockingPeriod la propriété.
Regroupement	'true'	Lorsque la valeur de cette clé est définie sur true, toute connexion nouvellement créée est ajoutée au pool lorsqu’elle est fermée par l’application. Dans une prochaine tentative d’ouverture de la même connexion, cette connexion sera extraite du pool. Les connexions sont considérées comme identiques si elles ont la même chaîne de connexion. Différentes connexions ont des chaînes de connexion différentes. La valeur de cette clé peut être « true », « false », « oui » ou « non ».
Réplication	'false'	true si la réplication est prise en charge à l’aide de la connexion.
SPN du serveur - ou - ServerSPN	N/A	SpN pour la source de données. La valeur par défaut est une chaîne vide, ce qui permet à SqlClient d’utiliser le SPN généré par le pilote par défaut. (Disponible uniquement dans v5.0+)
Liaison de transaction	Déliaison implicite	Contrôle l’association de connexion avec une transaction inscrite System.Transactions . Les valeurs possibles sont les suivantes : Transaction Binding=Implicit Unbind; Transaction Binding=Explicit Unbind; La liaison implicite provoque le détachement de la connexion à la transaction lorsqu’elle se termine. Après le détachement, des requêtes supplémentaires sur la connexion sont effectuées en mode de validation automatique. La System.Transactions.Transaction.Current propriété n’est pas vérifiée lors de l’exécution des requêtes pendant que la transaction est active. Une fois la transaction terminée, des demandes supplémentaires sont effectuées en mode de validation automatique. Si le système met fin à la transaction (dans l’étendue d’un bloc d’utilisation) avant la fin de la dernière commande, elle lève InvalidOperationException. La liaison explicite provoque l’attachement de la connexion à la transaction jusqu’à ce que la connexion soit fermée ou qu’une connexion explicite SqlConnection.TransactionEnlist(null) soit appelée. À compter de .NET Framework 4.0, les modifications apportées à Unbind implicite rendent l’annulation explicite obsolète. Une InvalidOperationException valeur est levée si Transaction.Current elle n’est pas la transaction inscrite ou si la transaction inscrite n’est pas active.
Résolution transparente des adresses IP du réseau - ou - TransparentNetworkIPResolution	Consultez la description.	Lorsque la valeur de cette clé est définie true, l’application est requise pour récupérer toutes les adresses IP d’une entrée DNS particulière et tenter de se connecter au premier de la liste. Si la connexion n’est pas établie dans les 0,5 secondes, l’application tente de se connecter à tous les autres en parallèle. Lorsque les premières réponses sont fournies, l’application établit la connexion avec l’adresse IP du répondant. Si la MultiSubnetFailover clé est définie truesur , TransparentNetworkIPResolution est ignorée. Si la Failover Partner clé est définie, TransparentNetworkIPResolution elle est ignorée. La valeur de cette clé doit être true, false, yesou no. Une valeur de yes est traitée de la même façon qu’une valeur de true. Une valeur de no est traitée de la même façon qu’une valeur de false. Les valeurs par défaut sont les suivantes : false Quand: Connexion à Azure SQL Database où la source de données se termine par : .database.chinacloudapi.cn .database.usgovcloudapi.net .database.cloudapi.de .database.windows.net .database.fabric.microsoft.com Authentication est « Mot de passe Active Directory » ou « Active Directory intégré » true dans tous les autres cas.
Certificat de serveur de confiance - ou - TrustServerCertificate	'false'	Lorsqu’il est défini truesur , TLS est utilisé pour chiffrer le canal lors du contournement de la marche à pied de la chaîne de certificats pour valider l’approbation. Si TrustServerCertificate est défini true sur et encrypt est défini falsesur , le canal n’est pas chiffré. Les valeurs reconnues sont true, false, yes et no. Pour plus d’informations, consultez Syntaxe de la chaîne de connexion.
Version du système de type	N/A	Valeur de chaîne qui indique le système de type attendu par l’application. La fonctionnalité disponible pour une application cliente dépend de la version de SQL Server et du niveau de compatibilité de la base de données. Définir explicitement la version du système de type que l’application cliente a été écrite pour éviter les problèmes potentiels susceptibles de provoquer l’arrêt d’une application si une autre version de SQL Server est utilisée. Note: La version du système de type ne peut pas être définie pour le code CLR (Common Language Runtime) en cours d’exécution dans SQL Server. Pour plus d’informations, consultez Intégration du Common Language Runtime SQL Server. Les valeurs possibles sont les suivantes : Type System Version=SQL Server 2012; Type System Version=SQL Server 2008; Type System Version=SQL Server 2005; Type System Version=Latest; Type System Version=SQL Server 2012; spécifie que l’application nécessite la version 11.0.0.0 de Microsoft.SqlServer.Types.dll. Les autres Type System Version paramètres nécessitent la version 10.0.0.0 de Microsoft.SqlServer.Types.dll. La méthode Latest est obsolète et ne doit pas être utilisée. Latest est équivalent à Type System Version=SQL Server 2008;.
ID d’utilisateur - ou - Identificateur d’utilisateur - ou - Utilisateur	N/A	Compte de connexion SQL Server. Non recommandé. Pour maintenir un niveau de sécurité élevé, nous vous recommandons vivement d’utiliser plutôt les mots clés ou Integrated Security les Trusted_Connection mots clés. SqlCredential est un moyen plus sécurisé de spécifier des informations d’identification pour une connexion qui utilise l’authentification SQL Server. L’ID utilisateur doit comporter 128 caractères ou moins.
Instance utilisateur	'false'	Valeur qui indique s’il faut rediriger la connexion de l’instance SQL Server Express par défaut vers une instance lancée par le runtime exécutée sous le compte de l’appelant.
ID Station de travail - ou - WSID	Nom de l’ordinateur local	Nom de la station de travail qui se connecte à SQL Server. L’ID doit comporter 128 caractères ou moins.

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)

• Enrôler

• Taille maximale du pool

• Taille minimale du pool

• Regroupement

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

Note

Le fournisseur de données .NET Framework pour SQL Server utilise son propre protocole pour communiquer avec SQL Server. Par conséquent, il ne prend pas en charge l’utilisation d’un nom de source de données ODBC (DSN) lors de la connexion à SQL Server, car il n’ajoute pas de couche ODBC.

Note

Les fichiers UDL (Universal Data Link) ne sont pas pris en charge pour le fournisseur de données .NET Framework pour SQL Server.

Avertissement

Dans cette version, l’application doit être prudent lors de la construction d’un chaîne de connexion en fonction de l’entrée de l’utilisateur (par exemple, lors de la récupération d’informations d’ID utilisateur et de mot de passe à partir d’une boîte de dialogue, puis de l’ajouter à l’chaîne de connexion). L’application doit s’assurer qu’un utilisateur ne peut pas incorporer des paramètres de chaîne de connexion supplémentaires dans ces valeurs (par exemple, en entrant un mot de passe comme « validpassword ; database=somedb » dans une tentative d’attachement à une autre base de données). Si vous devez construire des chaînes de connexion en fonction de l’entrée utilisateur, utilisez la nouvelle SqlConnectionStringBuilder, qui valide le chaîne de connexion et aide à éliminer ce problème. Pour plus d’informations, consultez Les générateurs de chaînes de connexion .