SqlConnection.ConnectionString Propriété

Définition

Espace de noms:

System.Data.SqlClient

Assembly:

System.Data.SqlClient.dll

Paquet:

System.Data.SqlClient v4.8.6

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

public override string ConnectionString { get; set; }

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.

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.

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

est ConnectionString 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 identique à l’ensemble ConnectionStringutilisateur , 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 ni ne retourne le mot de passe dans une chaîne de connexion, sauf si vous définissez Persist Security Infos 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é 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. SqlConnectionles propriétés retournent uniquement les paramètres contenus dans .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 à l’instance par défaut sur l’ordinateur local.

La réinitialisation de sur ConnectionString une 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 que vous 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 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’une 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 unique 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 unique 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 au sein d’un mot clé ou d’une valeur littéral de chaîne 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 = mon serveur ou Source de données = my"Server), sauf si un caractère de 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é	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.
Nom de l’application	N/A	Nom de l’application ou « Fournisseur de données .NET SQLClient » si aucun nom d’application n’est fourni. Un nom d’application peut comporter 128 caractères ou moins.
ApplicationIntent	ReadWrite	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.
Asynchronous Processing - ou - Async	'false'	Lorsque true, active la prise en charge des opérations asynchrones. Les valeurs reconnues sont true, false, yes et no. Cette propriété est ignorée à partir de .NET Framework 4.5. Pour plus d’informations sur la prise en charge de SqlClient pour la programmation asynchrone, consultez Programmation asynchrone.
AttachDBFilename - ou - Extended Properties - ou - Nom de fichier initial	N/A	Nom du fichier de base de données principal, y compris le nom du chemin d’accès complet d’une base de données attachable. 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 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 n’est pas attachée à 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 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 pointé par 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é « database » (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.
Authentification	N/A	La méthode d’authentification utilisée pour la connexion à SQL Database à l’aide de l’authentification Azure Active Directory. Les valeurs autorisées sont : Intégré Active Directory, Mot de passe Active Directory, Mot de passe Sql.
Paramètre de chiffrement de colonne	N/A	Active ou désactive Always Encrypted fonctionnalité pour la connexion.
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. Lors de l’ouverture d’une connexion à une base de données Azure SQL, définissez le délai d’expiration de la connexion sur 30 secondes.
Durée de vie de la connexion - ou - Load Balance Timeout	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. Une valeur de zéro (0) entraîne l’expiration maximale des connexions mises en pool.
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. La valeur par défaut est 1. 0 signifie ne pas tenter de se reconnecter (désactiver la résilience de connexion). Pour plus d’informations sur la résilience de connexion, consultez Paramètres SqlConnection .NET pour les nouvelles tentatives de connexion et Article technique - Résilience des connexions inactives.
ConnectRetryInterval	10	Spécifie le temps 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 rompue 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 est supérieur à 0. Si la première tentative de reconnexion échoue et que ConnectRetryCount est supérieur à 1, le client attend ConnectRetryInterval pour essayer la deuxième tentative et les tentatives de reconnexion suivantes. Pour plus d’informations sur la résilience de connexion, consultez Paramètres SqlConnection .NET pour les nouvelles tentatives de connexion et Article technique - Résilience des connexions inactives.
Connexion contextuelle	'false'	truesi une connexion in-process à SQL Server doit être établie.
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 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 Lorsque vous spécifiez une instance locale, utilisez toujours (local). Pour forcer un protocole, ajoutez l’un des préfixes suivants : np:(local), tcp:(local), lpc:(local) À compter de .NET Framework 4.5, 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:nom> d’hôte<\nom d’instance<> - tcp:nom d’hôte<>,< numéro de port TCP/IP> 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 base de données 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:\\nom d’hôte<\pipe\nom de< canal>> 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 Framework sera connectée. 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 en utilisant localhost.
Encrypt (Chiffrer)	'false'	Quand true, SQL Server utilise le chiffrement SSL pour toutes les données envoyées entre le client et le serveur si un certificat est installé sur le serveur. Les valeurs reconnues sont true, false, yes et no. Pour plus d’informations, consultez Syntaxe de la chaîne de connexion. À compter de .NET Framework 4.5, lorsque TrustServerCertificate a la valeur false et Encrypt a la valeur true, le nom du serveur (ou l’adresse IP) dans un certificat SSL SQL Server doit correspondre exactement au nom du serveur (ou adresse IP) spécifié dans la 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 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.
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'	Quand false, l’ID utilisateur et le mot de passe sont spécifiés dans la connexion. Quand true, les informations d’identification actuelles du compte Windows sont utilisées pour l’authentification. Les valeurs reconnues sont , , yes, et sspi (fortement recommandé), ce qui équivaut à true. nofalsetrue Si l’ID utilisateur et le mot de passe sont spécifiés et que La sécurité intégrée a la valeur 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).
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.
MultipleActiveResultSets	'false'	Quand true, une application peut gérer plusieurs jeux de résultats actifs (MARS). Quand , falseune 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 MARS (Multiple Active Result Sets).
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 de 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 à 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;
Packet Size	8000	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 connexion du compte SQL Server. Option non recommandée. Pour maintenir un niveau de sécurité élevé, nous vous recommandons vivement d’utiliser le mot clé 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 SQL Server Authentification. Le mot de passe doit contenir 128 caractères ou moins.
Persist Security Info - ou - PersistSecurityInfo	'false'	Lorsqu’il est défini sur ou no (fortement recommandé), les informations sensibles à false la sécurité, telles que le mot de passe, 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. 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.
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. Lors d’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 », « yes » ou « no ».
Réplication	'false'	true si la réplication est prise en charge à l’aide de la connexion.
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, les modifications apportées à l’unbind implicite rendent Unbind 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.
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.
TrustServerCertificate	'false'	Lorsqu’il trueest défini sur , SSL 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) s’exécutant 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. Latest est obsolète et ne doit pas être utilisé. 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 comporter 128 caractères ou moins.
User Instance	'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 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 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’équilibrage de charge)

• Enlist

• Max Pool Size

• Min Pool Size

• Pooling

Lorsque vous définissez des valeurs de regroupement de mots clés ou de connexions 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.

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 UDL (Universal Data Link) 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’une chaîne de connexion basée sur une 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 à la 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 basées sur l’entrée utilisateur, utilisez le nouveau SqlConnectionStringBuilder, qui valide la chaîne de connexion et aide à éliminer ce problème. Pour plus d’informations, consultez Générateurs de chaînes de connexion.

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