SqlConnection.ConnectionString Propriété

Définition

Espace de noms:

System.Data.SqlClient

Assembly:

System.Data.dll

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.

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

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.
Address	N/A	Synonyme de source de données.
App	N/A	Synonyme du nom de l’application.
Application Name	N/A	Nom de l’application ou « Fournisseur de données SQLClient .NET » 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. 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.
Asynchronous Processing - ou - Async	'false'	Quand 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 - Initial File Name	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.
Authentication	N/A	Méthode d’authentification utilisée pour la connexion à SQL Database à l’aide de l’authentification Azure Active Directory. Les valeurs valides sont les suivantes : Active Directory Intégré, Mot de passe Active Directory, Mot de passe Sql.
Column Encryption Setting	N/A	Active ou désactive la fonctionnalité Always Encrypted pour la connexion.
Connect Timeout - ou - Connection Timeout - ou - Timeout	15	Durée (en secondes) d’attente d’une connexion au serveur avant de terminer 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 Database, définissez le délai d’expiration de la connexion sur 30 secondes.
Connection Lifetime - 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. La valeur zéro (0) entraîne l’expiration maximale du délai d’expiration des connexions regroupées.
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. 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 des connexions, consultez les paramètres .NET SqlConnection pour la nouvelle tentative de connexion et l’article technique - Résilience de connexion inactive.
ConnectRetryInterval	10	Spécifie l’heure 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 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 des connexions, consultez les paramètres .NET SqlConnection pour la nouvelle tentative de connexion et l’article technique - Résilience de connexion inactive.
Context Connection	'false'	true si une connexion in-process à SQL Server doit être établie.
Current Language - 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.
Data Source - ou - Server - ou - Address - ou - Addr - ou - Network Address	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) À 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 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 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 à l’aide de localhost.
Encrypt	'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, quand TrustServerCertificate la valeur est false et Encrypt est 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 tentative de connexion échoue.
Enlist	'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.
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 - Database	N/A	Nom de la base de données. Le nom de la base de données peut comporter 128 caractères ou moins.
Integrated Security - 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).
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 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) .
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.
Network Library - ou - Network - 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.
Password - 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 Trusted_Connection le mot clé à la Integrated Security 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.
Persist Security Info - ou - PersistSecurityInfo	'false'	Lorsqu’elles sont définies false ou no (fortement recommandées), les informations sensibles à 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 n’a jamais é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 PoolBlockingPeriod la propriété.
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. 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 ».
Replication	'false'	true si la réplication est prise en charge à l’aide de la connexion.
Transaction Binding	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, les modifications apportées à unbind implicite rendent la liaison explicite non associée 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.
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 Authentication est « Mot de passe Active Directory » ou « Active Directory intégré » true dans tous les autres cas.
TrustServerCertificate	'false'	Lorsqu’il est défini truesur , SSL 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.
Type System Version	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;.
User ID - ou - UID - ou - User	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 Trusted_Connection les Integrated Security 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.
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 exécutée sous le compte de l’appelant.
Workstation ID - 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).

• Connection Lifetime (ou Load Balance Timeout)
• Enlist
• Max Pool Size
• Min Pool Size
• Pooling

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 yes au lieu de true, et no non pas 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

Utilisez une précaution lors de la construction d’une 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 l’ajout de celle-ci à la chaîne de connexion). Assurez-vous qu’un utilisateur ne peut pas incorporer de 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 SqlConnectionStringBuilder, qui valide la chaîne de connexion et aide à éliminer ce problème. Pour plus d’informations, voir constructeurs de chaînes de connexion.

Voir aussi

• ADO.NET Fournisseurs managés 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