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é

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.

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

ConnectionStringEst semblable à 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 à celle de l’utilisateur ConnectionString , moins les informations de sécurité si la valeur de Persist Security Info est définie sur false (valeur par défaut). Le Fournisseur de données .NET Framework pour SQL Server ne rend pas persistant ou ne retourne pas le mot de passe dans une chaîne de connexion, sauf si vous affectez à Persist Security Info la valeur 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 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 si 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 sur l’instance par défaut sur l’ordinateur local.

La réinitialisation ConnectionString de sur 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 comprend « Database = AdventureWorks », puis que vous réinitialisez la chaîne de connexion à « Data source = MyServer ; Integrated Security = true », la Database propriété n’a plus la valeur « 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 Runtime, telle que ArgumentException , est générée. D’autres erreurs ne peuvent être trouvées qu’en cas de tentative d’ouverture de la connexion.

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 caractère apostrophe ou un guillemet double, la valeur doit être placée entre guillemets doubles. Si la valeur contient à la fois un point-virgule et un caractère guillemet double, la valeur peut être placée entre guillemets simples. Le guillemet simple est également utile si la valeur commence par un caractère guillemet double. Inversement, le guillemet double peut être utilisé si la valeur commence par un guillemet simple. Si la valeur contient à la fois des guillemets simples et des guillemets doubles, le caractère guillemet utilisé pour encadrer la valeur doit être doublé à chaque fois qu’elle se produit dans la valeur.

Pour inclure des espaces de début ou de fin dans la valeur de chaîne, la valeur doit être placée entre des guillemets simples ou des guillemets doubles. 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 de littéral de chaîne sont conservés. Les guillemets simples ou doubles peuvent être utilisés dans une chaîne de connexion sans utiliser de délimiteurs (par exemple, Data source = my’Server ou Data Source = my "Server), sauf si un caractère 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 du nom de l’application.
Nom de l’application N/A Nom de l’application, ou « .NET SQLClient Fournisseur de données » 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
fausses 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 à compter 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 -

Propriétés étendues

- ou -

Nom de fichier initial
N/A Nom du fichier de base de données primaire, y compris le nom du chemin d’accès complet d’une base de données pouvant être attachée. 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é attachée précédemment, la base de données ne sera pas rattaché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 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 désigné par la chaîne de substitution. Remarque : Les noms de chemin d’accès de serveur distant, 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 l’exemple suivant :

"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 :

Active Directory intégrée, Active Directory mot de passe, mot de passe SQL.
Paramètre de chiffrement de colonne N/A Active ou désactive les fonctionnalités de Always Encrypted pour la connexion.
Connect Timeout

- ou -

Connection Timeout

- ou -

Délai d'expiration
15 Durée d’attente (en secondes) 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 à un Azure SQL Database, définissez le délai de connexion à 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) fait que les connexions regroupées ont le délai de connexion maximal.
ConnectRetryCount 1 Contrôle le nombre de tentatives de reconnexion après que le client a identifié un échec de connexion inactive. Les valeurs valides sont comprises entre 0 et 255. La valeur par défaut est 1. 0 signifie que vous ne tentez pas de vous reconnecter (désactiver la résilience de connexion).

Pour plus d’informations sur la résilience des connexions inactives, consultez Article technique, Résilience des connexions inactives.
ConnectRetryInterval 10 Spécifie le délai entre chaque nouvelle tentative de connexion (ConnectRetryCount). Les valeurs valides sont comprises entre 1 et 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 ne se produit que 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 seconde et les tentatives de reconnexion suivantes.

Pour plus d’informations sur la résilience des connexions inactives, consultez Article technique, Résilience des connexions inactives.
Connexion contextuelle fausses true Si 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

Quand 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 de base de données locale comme suit :

server=(localdb)\\myInstance

Pour plus d’informations sur la base de données locale, consultez prise en charge SqlClient pourla base de données locale.

La source de données doit utiliser le format TCP ou les canaux nommés.

Le format TCP est le suivant :

-TCP : <host name> \<nom de l’instance>
-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 sélectionné automatiquement pour les connexions à Azure SQL Database quand aucun protocole n’est spécifié.

Le nom d’hôte doit être spécifié de l’une des manières suivantes :

-NetBIOSName
-IPv4Address
-Adresseipv6

Le nom de l’instance est utilisé pour la résolution en 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 un numéro de port TCP/IP directement. Si le nom d’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 des canaux nommés est le suivant :

-NP : \ \<nom d’hôte > \pipe \<nom du canal>

Le format des 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
-Adresseipv6

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. Remarque : Vous pouvez forcer l’utilisation de TCP au lieu de la mémoire partagée, soit en préfixant TCP : au nom du serveur dans la chaîne de connexion, soit en utilisant localhost.
Encrypt (Chiffrer) fausses trueDans ce cas, 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 que Encrypt a la valeur true, le nom du serveur (ou l’adresse IP) dans un certificat SQL Server SSL doit correspondre exactement au nom du serveur (ou à l’adresse IP) spécifié dans la chaîne de connexion. Sinon, la connexion échouera.
Enlist 'true' true indique que le SQL Server Pooler 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 dans lequel 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é Server) 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é avec le mot clé Server) échoue 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
fausses Lorsque false l’ID d’utilisateur et le mot de passe sont spécifiés dans la connexion. Lorsque true la, les informations d’identification actuelles du compte Windows sont utilisées pour l’authentification.

Les valeurs reconnues sont true , false ,, yes no et sspi (fortement recommandé), qui est équivalent à 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 seront ignorés et la sécurité intégrée sera utilisée.

SqlCredential est un moyen plus sûr 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 fausses Lorsque la valeur true est, une application peut conserver plusieurs jeux de résultats actifs (mars). Lorsque la false valeur est, 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 toujours multiSubnetFailover=True 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 plus rapide et une connexion au serveur actif (actuellement). Les valeurs possibles sont Yes et No , True et False ou 1 0 . Exemple :

MultiSubnetFailover=True

La valeur par défaut est False. Pour plus d’informations sur la prise en charge de SqlClient pour Always On groupes, consultez prise en charge de SqlClient pour la haute disponibilité et 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 (multiprotocole, RPC Windows)

dbmsadsn (Apple parler)

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 du compte SQL Server qui ouvre une session. Option non recommandée. Pour maintenir un niveau de sécurité élevé, nous vous recommandons vivement d’utiliser Integrated Security le Trusted_Connection mot clé ou à la place. SqlCredential est un moyen plus sûr 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
fausses Lorsqu’il a la valeur false ou no (vivement recommandée), les informations sensibles sur 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 s’est déjà déplacée 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 la 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 une fois fermé 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 fausses true Si la réplication est prise en charge à l’aide de la connexion.
Transaction Binding Implicit Unbind Contrôle l’Association de connexion à une transaction inscrite System.Transactions .

Les valeurs possibles sont les suivantes :

Transaction Binding=Implicit Unbind;

Transaction Binding=Explicit Unbind;

Une annulation de liaison implicite entraîne le détachement de la connexion de la transaction lorsqu’elle se termine. 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, elle lève une exception InvalidOperationException .

La méthode Unbind explicite fait en sorte que la connexion reste attachée à la transaction jusqu’à ce que la connexion soit fermée ou qu’une expression explicite SqlConnection.TransactionEnlist(null) soit appelée. À compter de .NET Framework 4, les modifications apportées à Unbind implicite rendent la dissociation 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é a la valeur true , TransparentNetworkIPResolution est ignoré.

Si la Failover Partner clé est définie, TransparentNetworkIPResolution est ignoré.

La valeur de cette clé doit être true , false , yes ou no .

La valeur de yes est traitée de la même façon qu’une valeur de true .

La 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 à

    • 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 « Active Directory le mot de passe » ou « Active Directory intégré »
  • true dans tous les autres cas.
TrustServerCertificate fausses Si la valeur true est, SSL est utilisé pour chiffrer le canal lorsqu’il ignore le parcours de la chaîne de certificats pour valider l’approbation. Si TrustServerCertificate a la valeur true et que Encrypt a false la valeur, 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 que l’application attend. 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. Remarque : La version du système de type ne peut pas être définie pour le code common language runtime (CLR) qui s’exécute in-process dans SQL Server. Pour plus d’informations, consultez SQL Server l’intégration du 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écessitera 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 -
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 Integrated Security les Trusted_Connection Mots clés ou à la place. SqlCredential est un moyen plus sûr de spécifier des informations d’identification pour une connexion qui utilise l’authentification SQL Server.

L’ID d’utilisateur doit avoir 128 caractères au maximum.
User Instance fausses Valeur qui indique s’il faut rediriger la connexion de l’instance de SQL Server Express par défaut vers une instance initiée par l’exécution qui s’exécute sous le compte de l’appelant.
ID Station de travail

- ou -

WSID
Nom de l’ordinateur local Nom de la station de travail se connectant à 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 expiration de l’équilibrage de charge)

  • Enlist

  • Max Pool Size

  • Min Pool Size

  • Pooling

Quand vous définissez des valeurs de mot clé ou de regroupement de connexions qui requièrent 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 (DSN) ODBC 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 attention à la construction d’une chaîne de connexion basée sur l’entrée de l’utilisateur (par exemple, lors de la récupération des informations d’ID d’utilisateur et de mot de passe dans 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 sous la forme « validpassword ; Database = somedb » dans une tentative de rattachement à une autre base de données). Si vous devez construire des chaînes de connexion basées sur l’entrée d’utilisateur, utilisez le nouveau SqlConnectionStringBuilder , qui valide la chaîne de connexion et permet d’éliminer ce problème. Pour plus d’informations, consultez générateurs de chaînes de connexion .

S’applique à

Voir aussi