SqlConnection.ConnectionString Propriété

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

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 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.

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

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.

Mot clé	Default	Description
Addr	N/A	Synonyme de source de données.
Adresse	N/A	Synonyme de source de données.
Application	N/A	Synonyme de Nom de l’application.
Intention de l'application -ou- ApplicationIntent	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. 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 l’application. Si aucun nom d’application n’est fourni, « Framework Microsoft SqlClient Data Provider » lors de l’exécution sur .NET Framework et « Core Microsoft SqlClient Data Provider » dans le cas contraire. Un nom d’application peut comporter 128 caractères ou moins.
AttachDBFilename - ou - Extended Properties - 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 jointe. AttachDBFilename est uniquement pris en charge pour les fichiers de données principaux portant l'extension .mdf. Si la valeur de la clé AttachDBFileName est spécifiée dans le 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 n’est pas attachée de nouveau. 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é est utilisée comme alias. Toutefois, si le nom est déjà utilisé dans une autre base de données attachée, 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 UNC, HTTP et serveur distant ne sont pas pris en charge. Le nom de la base de données doit être spécifié avec le mot clé « base de données » (ou l’un de ses alias) comme suit : "AttachDbFileName=|DataDirectory|\data\YourDB.mdf;integrated security=true;database=YourDatabase" Une erreur est générée s'il existe un fichier journal dans le même répertoire que le fichier de données et si le mot clé « database » est utilisé lors de l'attachement du fichier de données principal. Dans ce cas, supprimez le fichier journal. Une fois que la base de données est attachée, un nouveau fichier journal est automatiquement généré en fonction du chemin d’accès physique.
Protocole d’attestation	NotSpecified	Obtient ou définit la valeur du protocole d’attestation. Quand aucune valeur n’est spécifiée, les enclaves sécurisées sont désactivées sur la connexion. Les valeurs autorisées sont : AAS HGS None (Valide uniquement dans v3.1 et v4.1+))
Authentification	N/A	Méthode d’authentification utilisée pour la connexion à SQL Database à l’aide de l’authentification Azure Active Directory. Les valeurs autorisées sont : 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 Utilisation de l’authentification Azure Active Directory avec SqlClient.
Paramètre de chiffrement de colonne	disabled	Active ou désactive Always Encrypted fonctionnalité pour la connexion. Les valeurs prises en charge sont : enabled et disabled
Délai d’expiration de commande	30	Temps d’attente par défaut (en secondes) avant de mettre fin à la tentative d’exécution d’une commande et de générer 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 a identifié 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 : Depuis la version 5.x, la valeur par défaut pour les points de terminaison non Azure est 1. Pour Azure SQL points de terminaison, la valeur par défaut est 2. Pour Azure SQL des 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 à un instance inactif ou suspendu. Pour plus d’informations sur la résilience des connexions inactives, consultez Paramètres .NET SqlConnection pour les tentatives de connexion et Article technique - Résilience des connexions inactives.
Intervalle avant nouvelle tentative de connexion -ou- ConnectRetryInterval	10	Spécifie le délai entre chaque 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 qui se produit uniquement si ConnectRetryCount est supérieur à 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 de reconnexion et les tentatives de reconnexion suivantes. Pour plus d’informations sur la résilience des connexions inactives, consultez Paramètres sqlConnection .NET pour les tentatives de connexion et Article technique - Résilience des connexions inactives.
Connect Timeout - ou - Connection Timeout - ou - Délai d'expiration	15	Durée (en secondes) d’attente d’une connexion au serveur avant de mettre fin à la tentative et de générer une erreur. Les valeurs valides sont supérieures ou égales à 0 et inférieures ou égales à 2147483647. Lorsque vous ouvrez une connexion à une base de données Azure SQL, définissez le délai d’expiration de connexion sur 30 secondes.
Current Language - ou - Langage	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 du instance de SQL Server auquel se connecter. Le numéro de port peut être spécifié après le nom du serveur : server=tcp:servername, portnumber Lorsque vous spécifiez un instance local, 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 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 du instance de base de données, comme spécifié par un nom d’hôte et un nom de 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 instance est utilisé pour résoudre un numéro de port TCP/IP particulier sur lequel une base de données instance est hébergée. Vous pouvez également spécifier directement un numéro de port TCP/IP. Si instance nom et numéro de port ne sont pas présents, le instance de base de données par défaut est utilisé. Le format canaux nommés est le suivant : - np :\\<host name>\pipe\<pipe name> 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 la base de données instance à laquelle l’application .NET se connectera. 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 le chaîne de connexion, soit en utilisant localhost.
URL d’attestation d’enclave	N/A	Obtient ou définit l’URL d’attestation d’enclave à utiliser avec les Always Encrypted basées sur les enclaves.
Encrypt (Chiffrer)	'true' dans les versions 4.0 et ultérieures 'false' dans 3.x et versions antérieures	Les valeurs reconnues sont les suivantes : versions 1 à 4 : true/yes et false/no versions 5+ : truemandatory/yes/, falseno//optional et .strict Quand true, le chiffrement TLS est utilisé pour toutes les données envoyées entre le client et le serveur si un certificat est installé sur le serveur. 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 à l’adresse IP) spécifié dans le chaîne de connexion. Sinon, la connexion échouera.
Enlist	'true'	trueindique que le pooleur de connexions SQL Server inscrit automatiquement la connexion dans le contexte de transaction actuel du thread de création.
Failover Partner	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 serveur mot clé) 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 serveur mot clé) réussit si le serveur principal est disponible.
SPN du partenaire de basculement -ou- FailoverPartnerSPN	N/A	Nom principal de service du partenaire de basculement. La valeur par défaut est une chaîne vide, ce qui oblige SqlClient à utiliser le SPN par défaut généré par le pilote. (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 du certificat. (Disponible uniquement dans v5.0+)
Certificat de serveur -ou- ServerCertificate	N/A	Chemin d’accès à un fichier de certificat à mettre en correspondance avec le certificat TLS/SSL SQL Server. Les formats de certificat acceptés sont PEM, DER et CER. S’il est spécifié, le certificat SQL Server est vérifié en vérifiant si le certificat ServerCertificate fourni correspond exactement. (Disponible uniquement dans v5.1+)
Initial Catalog - 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'	Lorsque false, l’ID utilisateur et le mot de passe sont spécifiés dans la connexion. Quand true, les informations d’identification du compte Windows actuelles sont utilisées pour l’authentification. Les valeurs reconnues sont , , yes, et sspi (fortement recommandé), ce qui équivaut à true. nofalsetrue 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 utilisateur et le mot de passe sont ignorés et la sécurité intégrée est utilisée. SqlCredentialest un moyen plus sécurisé de spécifier les informations d’identification d’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 est défini sur true, ce paramètre n’a aucun effet. Les valeurs prises en charge sont : IPAddressPreference=IPv4First IPAddressPreference=IPv6First IPAddressPreference=UsePlatformDefault
Load Balance Timeout -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 mises en pool.
Max Pool Size	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.
Min Pool Size	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 MARS (Multiple Active Result Set) -ou- MultipleActiveResultSets	false	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 un autre lot sur cette connexion. Les valeurs reconnues sont true et false. Pour plus d’informations, consultez MARS (Multiple Active Result Sets).
Basculement de plusieurs sous-réseaux -ou- MultiSubnetFailover	false	Spécifiez multiSubnetFailover=True toujours lors de la connexion à l’écouteur de 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 (actuellement) actif. Les valeurs possibles sont Yes et No, True et False ou 1 et .0 Exemple : MultiSubnetFailover=True La valeur par défaut est False. Pour plus d’informations sur la prise en charge par SqlClient pour les groupes de disponibilité Always On, consultez Prise en charge de SqlClient pour la haute disponibilité, la récupération d’urgence.
Network Library - ou - Réseau - ou - Net	N/A	Bibliothèque réseau utilisée pour établir une connexion à un 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;
Packet Size	8000	Taille en octets des paquets réseau utilisés pour communiquer avec un 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 connexion du compte SQL Server. Option non recommandée. Pour maintenir un niveau de sécurité élevé, nous vous recommandons vivement d’utiliser ou mot clé à la Integrated SecurityTrusted_Connection place. SqlCredentialest un moyen plus sécurisé de spécifier les informations d’identification d’une connexion qui utilise l’authentification SQL Server. Le mot de passe doit comporter 128 caractères ou moins.
Persist Security Info - ou - PersistSecurityInfo	'false'	Lorsqu’elle est définie sur ou no (fortement recommandée), les informations sensibles à false 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 si elle a déjà été dans un état ouvert. Cette propriété ne doit être définie sur 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 par défaut de false est le paramètre le plus sécurisé ; l’utilisation true de pour 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 du chaîne de connexion réinitialise toutes les valeurs 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- PoolBlockingPeriod	Auto	Définit le comportement de période de blocage pour un pool de connexions. Pour plus d'informations, consultez la propriété PoolBlockingPeriod.
Pooling	'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. Connections sont considérés comme identiques s’ils ont le 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 », « yes » ou « no ».
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 de la source de données. La valeur par défaut est une chaîne vide, ce qui oblige SqlClient à utiliser le SPN par défaut généré par le pilote. (Disponible uniquement dans v5.0+)
Transaction Binding	Implicit Unbind	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; Unbind implicite entraîne le détachement de la connexion de la transaction à la fin de celle-ci. Après le détachement, les requêtes supplémentaires sur la connexion sont exécutées en mode de validation automatique. La propriété System.Transactions.Transaction.Current n’est pas vérifiée lors de l’exécution des requêtes alors que la transaction est active. Une fois la transaction terminée, les requêtes supplémentaires sont exécutées en mode de validation automatique. Si le système met fin à la transaction (dans l’étendue d’un bloc using) avant la fin de la dernière commande, il lève InvalidOperationException. Unbind explicite fait que la connexion reste attachée à 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 à l’annulation implicite rendent l’annulation explicite obsolète. Une exception InvalidOperationException est levée si Transaction.Current n'est pas la transaction inscrite ou si la transaction inscrite n'est pas active.
Résolution transparente d’adresses IP réseau -ou- TransparentNetworkIPResolution	Consultez la description.	Lorsque la valeur de cette clé est définie sur true, l’application doit récupérer toutes les adresses IP pour une entrée DNS spécifique et essayer de se connecter à la première dans la liste. Si la connexion n’est pas établie dans un délai de 0,5 seconde, l’application tente de se connecter à toutes les autres en parallèle. Lorsque la première répond, l’application établit une connexion avec l’adresse IP qui répond. Si la MultiSubnetFailover clé est définie sur true, TransparentNetworkIPResolution est ignoré. Si la Failover Partner clé est définie, TransparentNetworkIPResolution est ignoré. 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 base de données où la source de données se termine par : .database.chinacloudapi.cn .database.usgovcloudapi.net .database.cloudapi.de .database.windows.net Authentication est « Mot de passe Active Directory » ou « Active Directory Intégré » true dans tous les autres cas.
Faire confiance au certificat de serveur -ou- TrustServerCertificate	'false'	Lorsqu’il trueest défini sur , TLS est utilisé pour chiffrer le canal lors du contournement de la chaîne de certificats pour valider l’approbation. Si TrustServerCertificate a la valeur true et Encrypt a la valeur false, 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.
Type Version du système	N/A	Valeur de chaîne qui indique le système de type attendu par l’application. Les fonctionnalités disponibles pour une application cliente dépendent de la version de SQL Server et du niveau de compatibilité de la base de données. L'affectation explicite de la version de système de type pour laquelle l'application cliente a été écrite évite d'éventuels problèmes qui pourraient entraîner l'arrêt d'une application si une version différente 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) qui s’exécute in-process dans SQL Server. Pour plus d’informations, consultez intégration SQL Server Common Language Runtime. 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 équivaut à Type System Version=SQL Server 2008;.
ID d'utilisateur - ou - Identificateur d’utilisateur - ou - Utilisateur	N/A	Compte de connexion SQL Server. Option non recommandée. Pour maintenir un niveau de sécurité élevé, nous vous recommandons vivement d’utiliser les mots clés ou Trusted_Connection à la Integrated Security place. SqlCredentialest un moyen plus sécurisé de spécifier les informations d’identification d’une connexion qui utilise l’authentification SQL Server. L’ID utilisateur doit contenir 128 caractères ou moins.
User Instance	'false'	Valeur qui indique s’il faut rediriger la connexion du SQL Server Express instance par défaut vers une instance lancée par le runtime s’exécutant 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 contenir 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)

• 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.

Notes

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.

Notes

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

Attention

Dans cette version, l’application doit faire preuve de prudence lors de la construction d’un chaîne de connexion en fonction de l’entrée utilisateur (par exemple, lors de la récupération des informations d’ID utilisateur et de mot de passe à partir d’une boîte de dialogue et de son ajout au 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 le nouveau SqlConnectionStringBuilder, qui valide les chaîne de connexion et aide à éliminer ce problème. Pour plus d’informations, consultez Générateurs de chaînes de connexion.