SqlConnection.ConnectionString Propriété

Définition

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:
 property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
public override string ConnectionString { get; set; }
[System.Data.DataSysDescription("SqlConnection_ConnectionString")]
public string ConnectionString { get; set; }
[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }
member this.ConnectionString : string with get, set
[<System.Data.DataSysDescription("SqlConnection_ConnectionString")>]
member this.ConnectionString : string with get, set
[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set
Public Overrides Property ConnectionString As String
Public Property ConnectionString As String

Valeur de propriété

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

Implémente

Attributs

Exceptions

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

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.
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 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=&#124;DataDirectory&#124;\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 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.

La valeur 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 des connexions, 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 et les tentatives de reconnexion suivantes.

Pour plus d’informations sur la résilience des connexions, 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 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)

À 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 :<host name>\<instance name>
- 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 la 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 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 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 :\\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 la base de données instance à 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 le 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 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.
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).
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 un 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 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 false est définie sur ou no (fortement recommandée), 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 si elle a déjà été dans un état ouvert. 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.
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.
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’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.
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ée.

Si la Failover Partner clé est définie, TransparentNetworkIPResolution 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 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 Chiffre 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.
Version du système de type 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.

S’applique à

Voir aussi