SqlConnection.ConnectionString SqlConnection.ConnectionString SqlConnection.ConnectionString SqlConnection.ConnectionString Property

Définition

Obtient ou définit la chaîne utilisée pour ouvrir une base de données SQL Server.Gets or sets the string used to open a SQL Server database.

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
[System.Data.DataSysDescription("SqlConnection_ConnectionString")]
[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }
member this.ConnectionString : string with get, set
Public Overrides 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.The connection string that includes the source database name, and other parameters needed to establish the initial connection. La valeur par défaut est une chaîne vide.The default value is an empty string.

Implémente

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.An invalid connection string argument has been supplied, or a required connection string argument has not been supplied.

Exemples

L’exemple suivant crée un SqlConnection et définit le ConnectionString propriété avant d’ouvrir la connexion.The following example creates a SqlConnection and sets the ConnectionString property before opening the connection.

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 à une chaîne de connexion OLE DB, mais n’est pas identique.The ConnectionString is similar to an OLE DB connection string, but is not identical. Contrairement à OLE DB ou ADO, la chaîne de connexion qui est retournée est identique à l’ensemble d’utilisateurs ConnectionString, moins les informations de sécurité si la valeur Persist Security Info est définie sur false (valeur par défaut).Unlike OLE DB or ADO, the connection string that is returned is the same as the user-set ConnectionString, minus security information if the Persist Security Info value is set to false (default). Le fournisseur de données .NET Framework pour SQL Server ne pas conserver ou retourner le mot de passe dans une chaîne de connexion, sauf si vous affectez à Persist Security Info true.The .NET Framework Data Provider for SQL Server does not persist or return the password in a connection string unless you set Persist Security Info to true.

Vous pouvez utiliser le ConnectionString propriété pour se connecter à une base de données.You can use the ConnectionString property to connect to a database. L’exemple suivant illustre une chaîne de connexion par défaut.The following example illustrates a typical connection string.

"Persist Security Info=False;Integrated Security=true;Initial Catalog=Northwind;server=(local)"  

Utilisez la nouvelle SqlConnectionStringBuilder pour construire des chaînes de connexion valides au moment de l’exécution.Use the new SqlConnectionStringBuilder to construct valid connection strings at run time. Pour plus d’informations, consultez Builders de chaînes de connexion.For more information, see Connection String Builders.

Le ConnectionString propriété peut être définie uniquement lorsque la connexion est fermée.The ConnectionString property can be set only when the connection is closed. La plupart des valeurs de chaîne de connexion ont des propriétés en lecture seule correspondantes.Many of the connection string values have corresponding read-only properties. Lorsque la chaîne de connexion est définie, ces propriétés sont mises à jour, sauf si une erreur est détectée.When the connection string is set, these properties are updated, except when an error is detected. Dans ce cas, aucune des propriétés sont mises à jour.In this case, none of the properties are updated. SqlConnection propriétés retournent uniquement les paramètres qui sont contenus dans le ConnectionString.SqlConnection properties return only those settings that are contained in the ConnectionString.

Pour vous connecter à un ordinateur local, spécifiez « (local) » pour le serveur.To connect to a local computer, specify "(local)" for the server. Si un nom de serveur n’est pas spécifié, une connexion est tentée à l’instance par défaut sur l’ordinateur local.If a server name is not specified, a connection will be attempted to the default instance on the local computer.

Réinitialiser le ConnectionString sur une connexion fermée rétablit toutes les valeurs de chaîne de connexion (et les propriétés associées), y compris le mot de passe.Resetting the ConnectionString on a closed connection resets all connection string values (and related properties) including the password. Par exemple, si vous définissez une chaîne de connexion qui inclut » base de données = AdventureWorks », puis réinitialisez la chaîne de connexion à « Source de données = myserver ; Integrated Security = true », le Database propriété n’est plus définie à « AdventureWorks ».For example, if you set a connection string that includes "Database= AdventureWorks", and then reset the connection string to "Data Source=myserver;Integrated Security=true", the Database property is no longer set to "AdventureWorks".

La chaîne de connexion est analysée immédiatement après avoir été défini.The connection string is parsed immediately after being set. Si les erreurs de syntaxe sont détectées lors de l’analyse, une exception runtime, tels que ArgumentException, est généré.If errors in syntax are found when parsing, a runtime exception, such as ArgumentException, is generated. Vous trouverez d’autres erreurs uniquement lorsqu’une tentative est faite pour ouvrir la connexion.Other errors can be found only when an attempt is made to open the connection.

Le format de chaîne de connexion de base inclut une série de paires mot clé/valeur séparées par des points-virgules.The basic format of a connection string includes a series of keyword/value pairs separated by semicolons. Le signe égal (=) sert de lien entre chaque mot clé et sa valeur.The equal sign (=) connects each keyword and its value. Pour inclure les valeurs qui contiennent un point-virgule, un caractère guillemet unique ou un caractère guillemet double, la valeur doit être placée entre guillemets doubles.To include values that contain a semicolon, single-quote character, or double-quote character, the value must be enclosed in double quotation marks. Si la valeur contient un point-virgule et un caractère guillemet double, la valeur peut être placée entre guillemets simples.If the value contains both a semicolon and a double-quote character, the value can be enclosed in single quotation marks. Le guillemet simple est également utile si la valeur commence par un caractère de guillemet double.The single quotation mark is also useful if the value starts with a double-quote character. À l’inverse, le guillemet double peut être utilisé si la valeur commence par un guillemet simple.Conversely, the double quotation mark can be used if the value starts with a single quotation mark. Si la valeur contient des caractères de guillemet simple et guillemet double, le caractère guillemet permettant de délimiter la valeur doit être double chaque fois qu’il se trouve dans la valeur.If the value contains both single-quote and double-quote characters, the quotation mark character used to enclose the value must be doubled every time it occurs within the value.

Pour inclure des espaces de début ou de fin dans la valeur de chaîne, la valeur doit être placée entre dans les guillemets simples ou des guillemets doubles.To include preceding or trailing spaces in the string value, the value must be enclosed in either single quotation marks or double quotation marks. Les espaces de début ou de fin autour d’entier, booléen ou valeurs énumérées sont ignorés, même si entourée de guillemets.Any leading or trailing spaces around integer, Boolean, or enumerated values are ignored, even if enclosed in quotation marks. Toutefois, les espaces au sein d’un mot clé de chaîne littérale ou une valeur sont conservés.However, spaces within a string literal keyword or value are preserved. Des guillemets simples ou doubles peuvent servir au sein d’une chaîne de connexion sans délimiteurs (par exemple, Data Source = my'Server ou la Source de données = mon serveur »), sauf si un caractère guillemet est le premier ou dernier caractère dans la valeur.Single or double quotation marks may be used within a connection string without using delimiters (for example, Data Source= my'Server or Data Source= my"Server), unless a quotation mark character is the first or last character in the value.

Mots clés ne respectent pas la casse.Keywords are not case sensitive.

Le tableau suivant répertorie les noms valides pour les valeurs de mot clé dans le ConnectionString.The following table lists the valid names for keyword values within the ConnectionString.

Mot cléKeyword Par défautDefault DescriptionDescription
AddrAddr N/AN/A Synonyme de Source de données.Synonym of Data Source.
AdresseAddress N/AN/A Synonyme de Source de données.Synonym of Data Source.
ApplicationApp N/AN/A Synonyme de nom de l’Application.Synonym of Application Name.
Application NameApplication Name N/AN/A Le nom de l’application, ou « .NET SQLClient Data Provider » si aucun nom de l’application n’est fournie.The name of the application, or '.NET SQLClient Data Provider' if no application name is provided.

Un nom d’application peut être de 128 caractères ou moins.An application name can be 128 characters or less.
ApplicationIntent ReadWrite Déclare le type de charge de travail d’application lors de la connexion à un serveur.Declares the application workload type when connecting to a server. Les valeurs possibles sont ReadOnly et ReadWrite.Possible values are ReadOnly and ReadWrite. Exemple :For example:

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.For more information about SqlClient support for Always On Availability Groups, see SqlClient Support for High Availability, Disaster Recovery.
Asynchronous ProcessingAsynchronous Processing

ou-or-

AsyncAsync
« false »'false' Lorsque true, permet la prise en charge de l’opération asynchrone.When true, enables asynchronous operation support. Les valeurs reconnues sont true, false, yes et no.Recognized values are true, false, yes, and no.

Cette propriété est ignorée à compter de .NET Framework 4.5.NET Framework 4.5.This property is ignored beginning in .NET Framework 4.5.NET Framework 4.5. Pour plus d’informations sur la prise en charge de SqlClient pour la programmation asynchrone, consultez programmation asynchrone.For more information about SqlClient support for asynchronous programming, see Asynchronous Programming.
AttachDBFilenameAttachDBFilename

ou-or-

Propriétés étenduesExtended Properties

ou-or-

Nom de fichier initialInitial File Name
N/AN/A Le nom du fichier de base de données primaire, y compris le nom de chemin d’accès complet d’une base de données pouvant être attachée.The name of the primary database file, including the full path name of an attachable database. AttachDBFilename est uniquement pris en charge pour les fichiers de données principaux portant l’extension .mdf.AttachDBFilename is only supported for primary data files with an .mdf extension.

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.If the value of the AttachDBFileName key is specified in the connection string, the database is attached and becomes the default database for the connection.

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 reconnecté.If this key is not specified and if the database was previously attached, the database will not be reattached. La base de données attachée précédemment sera utilisé comme base de données par défaut pour la connexion.The previously attached database will be used as the default database for the connection.

Si cette clé est spécifiée avec la clé AttachDBFileName, la valeur de cette clé sera utilisée comme alias.If this key is specified together with the AttachDBFileName key, the value of this key will be used as the alias. Toutefois, si le nom est déjà utilisé dans une autre base de données attachée, la connexion échoue.However, if the name is already used in another attached database, the connection will fail.

Le chemin d’accès peut être absolu ou relatif à l’aide de la chaîne de substitution DataDirectory.The path may be absolute or relative by using the DataDirectory substitution string. Si DataDirectory est utilisé, le fichier de base de données doit exister dans un sous-répertoire du répertoire vers lequel pointé la chaîne de substitution.If DataDirectory is used, the database file must exist within a subdirectory of the directory pointed to by the substitution string. Remarque : Serveur distant, HTTP et UNC des noms de chemin d’accès ne sont pas pris en charge.Note: Remote server, HTTP, and UNC path names are not supported.

Le nom de base de données doit être spécifié avec le mot clé 'database' (ou un de ses alias) comme suit :The database name must be specified with the keyword 'database' (or one of its aliases) as in the following:

"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.An error will be generated if a log file exists in the same directory as the data file and the 'database' keyword is used when attaching the primary data file. Dans ce cas, supprimez le fichier journal.In this case, remove the log file. 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.Once the database is attached, a new log file will be automatically generated based on the physical path.
AuthentificationAuthentication N/AN/A La méthode d’authentification utilisée pour connexion à SQL de base de données avec l’Azure Active Directory authentification.The authentication method used for Connecting to SQL Database By Using Azure Active Directory Authentication.

Les valeurs valides sont les suivantes :Valid values are:

Active Directory intégrée, Active Directory mot de passe, mot de passe Sql.Active Directory Integrated, Active Directory Password, Sql Password.
Paramètre de chiffrement de colonneColumn Encryption Setting N/AN/A Active ou désactive Always Encrypted fonctionnalité pour la connexion.Enables or disables Always Encrypted functionality for the connection.
Délai de connexionConnect Timeout

ou-or-

Connection TimeoutConnection Timeout

ou-or-

DélaiTimeout
1515 Durée (en secondes) d’attente pour une connexion au serveur avant d’abandonner la tentative et de générer une erreur.The length of time (in seconds) to wait for a connection to the server before terminating the attempt and generating an error.

Les valeurs valides sont supérieur ou égal à 0 et inférieur ou égal à 2147483647.Valid values are greater than or equal to 0 and less than or equal to 2147483647.

Lorsque vous ouvrez une connexion à une base de données SQL Azure, définissez le délai de connexion à 30 secondes.When opening a connection to a Azure SQL Database, set the connection timeout to 30 seconds.
Durée de vie de connexionConnection Lifetime

ou-or-

Load Balance TimeoutLoad Balance Timeout
00 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.When a connection is returned to the pool, its creation time is compared with the current time, and the connection is destroyed if that time span (in seconds) exceeds the value specified by 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.This is useful in clustered configurations to force load balancing between a running server and a server just brought online.

Une valeur égale à zéro (0) entraîne le délai d’attente maximal de connexion pour connexions regroupées.A value of zero (0) causes pooled connections to have the maximum connection timeout.
ConnectRetryCountConnectRetryCount 11 Contrôles le nombre de nouvelles tentatives après que le client identifie un échec de connexion inactive.Controls the number of reconnection attempts after the client identifies an idle connection failure. Les valeurs valides sont compris entre 0 et 255.Valid values are 0 to 255. La valeur par défaut est 1.The default is 1. 0 signifie n’essayez pas de se reconnecter (désactiver la résilience des connexions).0 means do not attempt to reconnect (disable connection resiliency).

Pour plus d’informations sur la résilience des connexions inactives, consultez Article technique - Idle Connection Resiliency.For additional information about idle connection resiliency, see Technical Article - Idle Connection Resiliency.
ConnectRetryIntervalConnectRetryInterval 1010 Spécifie le délai entre chaque nouvelle tentative de connexion (ConnectRetryCount).Specifies the time between each connection retry attempt (ConnectRetryCount). Les valeurs valides sont comprises entre 1 et 60 secondes (valeur par défaut = 10), il est appliqué après la première tentative de reconnexion.Valid values are 1 to 60 seconds (default=10), applied after the first reconnection attempt. Lorsqu’une connexion interrompue est détectée, le client immédiatement tente de se reconnecter ; Ceci est la première tentative de reconnexion et se produit uniquement si ConnectRetryCount est supérieur à 0.When a broken connection is detected, the client immediately attempts to reconnect; this is the first reconnection attempt and only occurs if ConnectRetryCount is greater than 0. Si la première tentative de reconnexion échoue et ConnectRetryCount est supérieur à 1, le client attend ConnectRetryInterval pour essayer les tentatives de reconnexion suivantes.If the first reconnection attempt fails and ConnectRetryCount is greater than 1, the client waits ConnectRetryInterval to try the second and subsequent reconnection attempts.

Pour plus d’informations sur la résilience des connexions inactives, consultez Article technique - Idle Connection Resiliency.For additional information about idle connection resiliency, see Technical Article - Idle Connection Resiliency.
Context ConnectionContext Connection « false »'false' true Si une connexion dans le processus à SQL Server doit être établie.true if an in-process connection to SQL Server should be made.
Current LanguageCurrent Language

ou-or-

LangueLanguage
N/AN/A Définit la langue utilisée pour les messages d’avertissement ou erreur serveur base de données.Sets the language used for database server warning or error messages.

Le nom de la langue peut être de 128 caractères ou moins.The language name can be 128 characters or less.
source de donnéesData Source

ou-or-

ServeurServer

ou-or-

AdresseAddress

ou-or-

AddrAddr

ou-or-

Adresse réseauNetwork Address
N/AN/A Le nom ou adresse réseau de l’instance de SQL Server à laquelle se connecter.The name or network address of the instance of SQL Server to which to connect. Le numéro de port peut être spécifié après le nom du serveur :The port number can be specified after the server name:

server=tcp:servername, portnumber

Lorsque vous spécifiez une instance locale, utilisez toujours (local).When specifying a local instance, always use (local). Pour forcer un protocole, ajoutez l’un des préfixes suivants :To force a protocol, add one of the following prefixes:

np:(local), tcp:(local), lpc:(local)

À compter de .NET Framework 4.5.NET Framework 4.5, vous pouvez également vous connecter à une base de données LocalDB comme suit :Beginning in .NET Framework 4.5.NET Framework 4.5, you can also connect to a LocalDB database as follows:

server=(localdb)\\myInstance

Pour plus d’informations sur la base de données locale, consultez prise en charge de SqlClient pour LocalDB.For more information about LocalDB, see SqlClient Support for LocalDB.

Source de données doit utiliser le format TCP ou canaux nommés.Data Source must use the TCP format or the Named Pipes format.

Format TCP est le suivant :TCP format is as follows:

-tcp :<nom d’hôte >\< nom de l’instance>- tcp:<host name>\<instance name>
-tcp :<nom d’hôte >,<numéro de port TCP/IP >- tcp:<host name>,<TCP/IP port number>

Le format TCP doit commencer par le préfixe « tcp : » et est suivi par l’instance de base de données, tel que spécifié par un nom d’hôte et un nom d’instance.The TCP format must start with the prefix "tcp:" and is followed by the database instance, as specified by a host name and an instance name. Ce format n’est pas applicable lors de la connexion à la base de données SQL Azure.This format is not applicable when connecting to Azure SQL Database. TCP est automatiquement sélectionné pour les connexions à la base de données SQL Azure lorsqu’aucun protocole n’est spécifié.TCP is automatically selected for connections to Azure SQL Database when no protocol is specified.

Le nom d’hôte doit être spécifié dans une des manières suivantes :The host name MUST be specified in one of the following ways:

- NetBIOSName- NetBIOSName
- IPv4Address- IPv4Address
- IPv6Address- IPv6Address

Le nom d’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.The instance name is used to resolve to a particular TCP/IP port number on which a database instance is hosted. Vous pouvez également indiquer un numéro de port TCP/IP directement est également autorisé.Alternatively, specifying a TCP/IP port number directly is also allowed. Si les deux 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é.If both instance name and port number are not present, the default database instance is used.

Le format de canaux nommés est comme suit :The Named Pipes format is as follows:

-np :\\< nom d’hôte>\pipe\< nom du canal>- np:\\<host name>\pipe\<pipe name>

Le format de canaux nommés doit commencer par le préfixe « np : » et est suivi d’un nom de canal nommé.The Named Pipes format MUST start with the prefix "np:" and is followed by a named pipe name.

Le nom d’hôte doit être spécifié dans une des manières suivantes :The host name MUST be specified in one of the following ways:

- NetBIOSName- NetBIOSName
- IPv4Address- IPv4Address
- IPv6Address- IPv6Address

Le nom du canal est utilisé pour identifier l’instance de base de données à laquelle l’application .NET Framework se connecteront.The pipe name is used to identify the database instance to which the .NET Framework application will be connected.

Si la valeur de la réseau clé est spécifiée, les préfixes « tcp : » et « np : » ne doit pas être spécifié.If the value of the Network key is specified, the prefixes "tcp:" and "np:" should not be specified. Remarque : Vous pouvez forcer l’utilisation de TCP au lieu de la mémoire partagée, en faisant précéder tcp : au nom du serveur dans la chaîne de connexion, ou en utilisant localhost.Note: You can force the use of TCP instead of shared memory, either by prefixing tcp: to the server name in the connection string, or by using localhost.
EncryptEncrypt « false »'false' Lorsque true, SQL Server utilise le chiffrement SSL pour toutes les données envoyées entre le client et le serveur si le serveur a installé un certificat.When true, SQL Server uses SSL encryption for all data sent between the client and server if the server has a certificate installed. Les valeurs reconnues sont true, false, yes et no.Recognized values are true, false, yes, and no. Pour plus d’informations, consultez syntaxe de chaîne de connexion.For more information, see Connection String Syntax.

À compter de .NET Framework 4.5.NET Framework 4.5, lorsque TrustServerCertificate a la valeur false et Encrypt a la valeur true, le nom du serveur (ou adresse IP) dans un certificat SSL SQL Server doit correspondre exactement au nom de serveur (ou adresse IP) spécifié dans la chaîne de connexion.Beginning in .NET Framework 4.5.NET Framework 4.5, when TrustServerCertificate is false and Encrypt is true, the server name (or IP address) in a SQL Server SSL certificate must exactly match the server name (or IP address) specified in the connection string. Sinon, la connexion échouera.Otherwise, the connection attempt will fail. Pour plus d’informations sur la prise en charge pour les certificats dont le sujet commence par un caractère générique (*), consultez accepté des caractères génériques utilisés par des certificats de serveur pour l’authentification de serveur.For information about support for certificates whose subject starts with a wildcard character (*), see Accepted wildcards used by server certificates for server authentication.
EnlistEnlist 'true''true' true Indique que le pooler de connexion SQL Server inscrit automatiquement la connexion dans le contexte de transaction actuel du thread de création.true indicates that the SQL Server connection pooler automatically enlists the connection in the creation thread's current transaction context.
Failover PartnerFailover Partner N/AN/A Le nom du serveur partenaire de basculement où la mise en miroir de base de données est configurée.The name of the failover partner server where database mirroring is configured.

Si la valeur de cette clé est « », puis Initial Catalog doit être présent, et sa valeur ne doit pas être « ».If the value of this key is "", then Initial Catalog must be present, and its value must not be "".

Le nom du serveur peut être de 128 caractères ou moins.The server name can be 128 characters or less.

Si vous spécifiez un partenaire de basculement, mais le serveur partenaire de basculement n’est pas configuré pour la mise en miroir de base de données et le serveur principal (spécifié avec le mot clé Server) n’est pas disponible, la connexion échoue.If you specify a failover partner but the failover partner server is not configured for database mirroring and the primary server (specified with the Server keyword) is not available, then the connection will fail.

Si vous spécifiez un partenaire de basculement et le serveur principal n’est pas configuré pour la mise en miroir de base de données, la connexion au serveur principal (spécifié avec le mot clé Server) réussit si le serveur principal est disponible.If you specify a failover partner and the primary server is not configured for database mirroring, the connection to the primary server (specified with the Server keyword) will succeed if the primary server is available.
Initial CatalogInitial Catalog

ou-or-

Base de donnéesDatabase
N/AN/A Le nom de la base de données.The name of the database.

Le nom de la base de données peut être de 128 caractères ou moins.The database name can be 128 characters or less.
Integrated SecurityIntegrated Security

ou-or-

Trusted_ConnectionTrusted_Connection
« false »'false' Lorsque false, ID d’utilisateur et mot de passe sont spécifiés dans la connexion.When false, User ID and Password are specified in the connection. Lorsque true, les informations d’identification de compte Windows actuelles sont utilisées pour l’authentification.When true, the current Windows account credentials are used for authentication.

Valeurs reconnues sont true, false, yes, no, et sspi (fortement recommandé), ce qui équivaut à true.Recognized values are true, false, yes, no, and sspi (strongly recommended), which is equivalent to true.

Si l’ID d’utilisateur et mot de passe sont spécifiés et intégré sécurité est définie sur true, l’ID d’utilisateur et mot de passe est ignoré et la sécurité intégrée sera utilisée.If User ID and Password are specified and Integrated Security is set to true, the User ID and Password will be ignored and Integrated Security will be used.

SqlCredential est un moyen plus sûr pour spécifier les informations d’identification pour une connexion qui utilise l’authentification SQL Server (Integrated Security=false).SqlCredential is a more secure way to specify credentials for a connection that uses SQL Server Authentication (Integrated Security=false).
Max Pool SizeMax Pool Size 100100 Le nombre maximal de connexions autorisées dans le pool.The maximum number of connections that are allowed in the pool.

Les valeurs valides sont supérieur ou égal à 1.Valid values are greater than or equal to 1. Les valeurs qui sont moins Min Pool Size génère une erreur.Values that are less than Min Pool Size generate an error.
Min Pool SizeMin Pool Size 00 Le nombre minimal de connexions autorisées dans le pool.The minimum number of connections that are allowed in the pool.

Les valeurs valides sont supérieur ou égal à 0.Valid values are greater than or equal to 0. Zéro (0) dans ce champ signifie qu'aucune connexion minimale n’est initialement ouvert.Zero (0) in this field means no minimum connections are initially opened.

Les valeurs qui sont supérieures à Max Pool Size génère une erreur.Values that are greater than Max Pool Size generate an error.
MultipleActiveResultSetsMultipleActiveResultSets « false »'false' Lorsque true, une application peut conserver plusieurs active ensembles de résultats (MARS).When true, an application can maintain multiple active result sets (MARS). Lorsque false, une application doit traiter ou annuler tous les jeux de résultats à partir d’un lot avant de pouvoir exécuter tout autre lot sur cette connexion.When false, an application must process or cancel all result sets from one batch before it can execute any other batch on that connection.

Valeurs reconnues sont true et false.Recognized values are true and false.

Pour plus d’informations, consultez MARS (Multiple Active Result Sets).For more information, see Multiple Active Result Sets (MARS).
MultiSubnetFailover FALSEFALSE Spécifiez toujours multiSubnetFailover=True lors de la connexion pour le groupe de disponibilité du port d’écoute d’un serveur SQL Server 2012 (ou version ultérieure) de groupe disponibilité ou une Instance SQL Server 2012 (ou version ultérieure) basculement Cluster.Always specify multiSubnetFailover=True when connecting to the availability group listener of a SQL Server 2012 (or later) availability group or a SQL Server 2012 (or later) Failover Cluster Instance. multiSubnetFailover=True Configure SqlClient pour fournir une détection plus rapide et une connexion au serveur (actuellement) actif.multiSubnetFailover=True configures SqlClient to provide faster detection of and connection to the (currently) active server. Les valeurs possibles sont Yes et No, True et False ou 1 et 0.Possible values are Yes and No, True and False or 1 and 0. Exemple :For example:

MultiSubnetFailover=True

La valeur par défaut est False.The default is False. Pour plus d’informations sur la prise en charge de SqlClient pour toujours sur les groupes de disponibilité, consultez prise en charge de SqlClient pour la haute disponibilité, récupération d’urgence.For more information about SqlClient's support for Always On AGs, see SqlClient Support for High Availability, Disaster Recovery.
Network LibraryNetwork Library

ou-or-

RéseauNetwork

ou-or-

NETNet
N/AN/A La bibliothèque réseau utilisée pour établir une connexion à une instance de SQL Server.The network library used to establish a connection to an instance of SQL Server. Les valeurs prises en charge sont :Supported values include:

dbnmpntw (canaux nommés)dbnmpntw (Named Pipes)

dbmsrpcn (multiprotocole, RPC de Windows)dbmsrpcn (Multiprotocol, Windows RPC)

dbmsadsn (Apple Talk)dbmsadsn (Apple Talk)

dbmsgnet (VIA)dbmsgnet (VIA)

dbmslpcn (mémoire partagée)dbmslpcn (Shared Memory)

dbmsspxn (IPX/SPX)dbmsspxn (IPX/SPX)

dbmssocn (TCP/IP)dbmssocn (TCP/IP)

Dbmsvinn (Banyan Vines)Dbmsvinn (Banyan Vines)

La DLL réseau correspondante doit être installée sur le système auquel vous vous connectez.The corresponding network DLL must be installed on the system to which you connect. Si vous ne spécifiez pas de réseau et que vous utilisez un serveur local (par exemple, «. » ou « (local) »), mémoire partagée est utilisée.If you do not specify a network and you use a local server (for example, "." or "(local)"), shared memory is used. Dans cet exemple, la bibliothèque réseau est Win32 Winsock TCP/IP (dbmssocn) et 1433 est le port utilisé.In this example, the network library is Win32 Winsock TCP/IP (dbmssocn), and 1433 is the port being used.

Network Library=dbmssocn;Data Source=000.000.000.000,1433;
Packet SizePacket Size 80008000 Taille en octets des paquets réseau permettant de communiquer avec une instance de SQL Server.Size in bytes of the network packets used to communicate with an instance of SQL Server.

La taille de paquet peut être supérieure ou égale à 512 et inférieure ou égale à 32768.The packet size can be greater than or equal to 512 and less than or equal to 32768.
Mot de passePassword

ou-or-

PWDPWD
N/AN/A Le mot de passe pour la session du compte SQL Server.The password for the SQL Server account logging on. Non recommandé.Not recommended. Pour maintenir un niveau élevé de sécurité, nous recommandons fortement d’utiliser le Integrated Security ou Trusted_Connection mot clé à la place.To maintain a high level of security, we strongly recommend that you use the Integrated Security or Trusted_Connection keyword instead. SqlCredential est un moyen plus sûr pour spécifier les informations d’identification pour une connexion qui utilise l’authentification SQL Server.SqlCredential is a more secure way to specify credentials for a connection that uses SQL Server Authentication.

Le mot de passe doit être de 128 caractères ou moins.The password must be 128 characters or less.
Persist Security InfoPersist Security Info

ou-or-

PersistSecurityInfoPersistSecurityInfo
« false »'false' Lorsque la valeur false ou no (fortement recommandé), les informations de sécurité sensibles, 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.When set to false or no (strongly recommended), security-sensitive information, such as the password, is not returned as part of the connection if the connection is open or has ever been in an open state. Réinitialisation de la chaîne de connexion réinitialise toutes les valeurs de chaîne de connexion, y compris le mot de passe.Resetting the connection string resets all connection string values including the password. Les valeurs reconnues sont true, false, yes et no.Recognized values are true, false, yes, and no.
PoolBlockingPeriodPoolBlockingPeriod AutoAuto Définit le comportement de période de blocage pour un pool de connexions.Sets the blocking period behavior for a connection pool. Consultez PoolBlockingPeriod pour plus d’informations.See PoolBlockingPeriod property for details.
PoolingPooling 'true''true' Lorsque la valeur de cette clé est définie sur true, récemment créés connexion sera ajoutée au pool de la fermeture de l’application.When the value of this key is set to true, any newly created connection will be added to the pool when closed by the application. Dans une prochaine tentative pour ouvrir la même connexion, cette connexion sera dessinée à partir du pool.In a next attempt to open the same connection, that connection will be drawn from the pool.

Les connexions sont considérés comme identiques s’ils ont la même chaîne de connexion.Connections are considered the same if they have the same connection string. Différentes connexions ont différentes chaînes de connexion.Different connections have different connection strings.

La valeur de cette clé peut être « true », « false », « Oui » ou « non ».The value of this key can be "true", "false", "yes", or "no".
ReplicationReplication « false »'false' true Si la réplication est prise en charge à l’aide de la connexion.true if replication is supported using the connection.
Transaction BindingTransaction Binding Implicit UnbindImplicit Unbind Contrôle l’association de connexion inscrite System.Transactions transaction.Controls connection association with an enlisted System.Transactions transaction.

Les valeurs possibles sont :Possible values are:

Transaction Binding=Implicit Unbind;

Transaction Binding=Explicit Unbind;

Annuler la liaison implicite provoque la connexion se détacher de la transaction lorsqu’elle se termine.Implicit Unbind causes the connection to detach from the transaction when it ends. Après le détachement, les requêtes supplémentaires sur la connexion sont exécutées en mode de validation automatique.After detaching, additional requests on the connection are performed in autocommit mode. 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.The System.Transactions.Transaction.Current property is not checked when executing requests while the transaction is active. Une fois la transaction terminée, les requêtes supplémentaires sont exécutées en mode de validation automatique.After the transaction has ended, additional requests are performed in autocommit mode.

Si le système termine la transaction (dans l’étendue d’un bloc) avant la fin de la dernière commande, il lève InvalidOperationException.If the system ends the transaction (in the scope of a using block) before the last command completes, it will throw InvalidOperationException.

Les causes d’annuler la liaison explicites la connexion reste attachée à la transaction jusqu'à ce que la connexion est fermée ou explicite SqlConnection.TransactionEnlist(null) est appelée.Explicit Unbind causes the connection to remain attached to the transaction until the connection is closed or an explicit SqlConnection.TransactionEnlist(null) is called. À compter de .NET Framework 4.NET Framework 4, modifications apportées à annuler la liaison implicite rendent obsolète.Beginning in .NET Framework 4.NET Framework 4, changes to Implicit Unbind make Explicit Unbind obsolete. Une exception InvalidOperationException est levée si Transaction.Current n'est pas la transaction inscrite ou si la transaction inscrite n'est pas active.An InvalidOperationException is thrown if Transaction.Current is not the enlisted transaction or if the enlisted transaction is not active.
TransparentNetworkIPResolutionTransparentNetworkIPResolution Consultez la description.See 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.When the value of this key is set to true, the application is required to retrieve all IP addresses for a particular DNS entry and attempt to connect with the first one in the list. 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.If the connection is not established within 0.5 seconds, the application will try to connect to all others in parallel. Lorsque la première répond, l’application établit une connexion avec l’adresse IP qui répond.When the first answers, the application will establish the connection with the respondent IP address.

Si le MultiSubnetFailover clé est définie sur true, TransparentNetworkIPResolution est ignoré.If the MultiSubnetFailover key is set to true, TransparentNetworkIPResolution is ignored.

Si le Failover Partner clé est définie, TransparentNetworkIPResolution est ignoré.If the Failover Partner key is set, TransparentNetworkIPResolution is ignored.

La valeur de cette clé doit être true, false, yes, ou no.The value of this key must be true, false, yes, or no.

La valeur yes est traité comme une valeur de true.A value of yes is treated the same as a value of true.

La valeur no est traité comme une valeur de false.A value of no is treated the same as a value of false.

Les valeurs par défaut sont comme suit :The default values are as follows:

  • false quand :false when:

    • Connexion à la base de données SQL Azure dans lequel la source de données se termine par :Connecting to Azure SQL Database where the data source ends with:

      • .database.chinacloudapi.cn.database.chinacloudapi.cn
      • .database.usgovcloudapi.net.database.usgovcloudapi.net
      • .database.cloudapi.de.database.cloudapi.de
      • .database.windows.net.database.windows.net
    • Authentication est 'Active Directory Password' ou « Intégrée à Active Directory »Authentication is 'Active Directory Password' or 'Active Directory Integrated'
  • true dans tous les autres cas.true in all other cases.
TrustServerCertificateTrustServerCertificate « false »'false' Lorsque la valeur true, SSL est utilisé pour chiffrer le canal lorsqu’en ignorant l’analyse de la chaîne de certificats pour valider l’approbation.When set to true, SSL is used to encrypt the channel when bypassing walking the certificate chain to validate trust. Si TrustServerCertificate a la valeur true et Encrypt a la valeur false, le canal n’est pas chiffré.If TrustServerCertificate is set to true and Encrypt is set to false, the channel is not encrypted. Les valeurs reconnues sont true, false, yes et no.Recognized values are true, false, yes, and no. Pour plus d’informations, consultez syntaxe de chaîne de connexion.For more information, see Connection String Syntax.
Version de système de typeType System Version N/AN/A Valeur de chaîne qui indique le système de type de l’application attend.A string value that indicates the type system the application expects. 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.The functionality available to a client application is dependent on the version of SQL Server and the compatibility level of the database. 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.Explicitly setting the type system version that the client application was written for avoids potential problems that could cause an application to break if a different version of SQL Server is used. Remarque : La version de système de type ne peut pas être définie pour le code CLR (Common Language Runtime) exécuté en mode in-process dans SQL Server.Note: The type system version cannot be set for common language runtime (CLR) code executing in-process in SQL Server. Pour plus d’informations, consultez intégration de Common Language Runtime dans SQL Server.For more information, see SQL Server Common Language Runtime Integration.

Les valeurs possibles sont :Possible values are:

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 requiert la version 11.0.0.0 de Microsoft.SqlServer.Types.dll.Type System Version=SQL Server 2012; specifies that the application will require version 11.0.0.0 of Microsoft.SqlServer.Types.dll. L’autre Type System Version paramètres requiert la version 10.0.0.0 de Microsoft.SqlServer.Types.dll.The other Type System Version settings will require version 10.0.0.0 of Microsoft.SqlServer.Types.dll.

Latest est obsolète et ne doit pas être utilisé.Latest is obsolete and should not be used. Latest équivaut à Type System Version=SQL Server 2008;.Latest is equivalent to Type System Version=SQL Server 2008;.
User IDUser ID

ou-or-

UIDUID

ou-or-
N/AN/A Le compte de connexion SQL Server.The SQL Server login account. Non recommandé.Not recommended. Pour maintenir un niveau élevé de sécurité, nous recommandons fortement d’utiliser le Integrated Security ou Trusted_Connection mots clés à la place.To maintain a high level of security, we strongly recommend that you use the Integrated Security or Trusted_Connection keywords instead. SqlCredential est un moyen plus sûr pour spécifier les informations d’identification pour une connexion qui utilise l’authentification SQL Server.SqlCredential is a more secure way to specify credentials for a connection that uses SQL Server Authentication.

L’ID d’utilisateur doit être de 128 caractères ou moins.The user ID must be 128 characters or less.
User InstanceUser Instance « false »'false' Une valeur qui indique s’il faut rediriger la connexion de l’instance de SQL Server Express par défaut vers une instance lancée à l’exécution en cours d’exécution sous le compte de l’appelant.A value that indicates whether to redirect the connection from the default SQL Server Express instance to a runtime-initiated instance running under the account of the caller.
Workstation IDWorkstation ID

ou-or-

WSIDWSID
Le nom de l’ordinateur localThe local computer name Le nom de la station de travail se connectant à SQL Server.The name of the workstation connecting to SQL Server.

L’ID doit être de 128 caractères ou moins.The ID must be 128 characters or less.

La liste suivante contient les noms valides pour les valeurs au sein de regroupement de connexions le ConnectionString.The following list contains the valid names for connection pooling values within the ConnectionString. Pour plus d’informations, consultez Regroupement de connexions SQL Server (ADO.NET).For more information, see SQL Server Connection Pooling (ADO.NET).

  • Durée de vie de connexion (ou Load Balance Timeout)Connection Lifetime (or Load Balance Timeout)

  • EnlistEnlist

  • Max Pool SizeMax Pool Size

  • Min Pool SizeMin Pool Size

  • PoolingPooling

Lorsque vous définissez un mot clé ou des valeurs qui requièrent une valeur booléenne de regroupement de connexions, vous pouvez utiliser « Oui » au lieu de « true » et « non » au lieu de 'false'.When you are setting keyword or connection pooling values that require a Boolean value, you can use 'yes' instead of 'true', and 'no' instead of 'false'. Valeurs entières sont représentées sous forme de chaînes.Integer values are represented as strings.

Notes

Le fournisseur de données .NET Framework pour SQL Server utilise son propre protocole pour communiquer avec SQL Server.The .NET Framework Data Provider for SQL Server uses its own protocol to communicate with 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 elle n’ajoute pas d’une couche ODBC.Therefore, it does not support the use of an ODBC data source name (DSN) when connecting to SQL Server because it does not add an ODBC layer.

Notes

Fichiers UDL (UDL) ne sont pas pris en charge pour le fournisseur de données .NET Framework pour SQL Server.Universal data link (UDL) files are not supported for the .NET Framework Data Provider for SQL Server.

Attention

Dans cette version, l’application doit utiliser attention lors de la construction d’une chaîne de connexion basée sur l’entrée d’utilisateur (par exemple, lors de la récupération des informations d’ID et mot de passe utilisateur à partir d’une boîte de dialogue et leur ajout à la chaîne de connexion).In this release, the application should use caution when constructing a connection string based on user input (for example when retrieving user ID and password information from a dialog box, and appending it to the connection string). 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, entrer un mot de passe en tant que » validpassword ; database = somedb » dans une tentative d’attachement à une autre base de données).The application should make sure that a user cannot embed additional connection string parameters in these values (for example, entering a password as "validpassword;database=somedb" in an attempt to attach to a different database). Si vous avez besoin construire des chaînes de connexion basées sur l’entrée d’utilisateur, utilisez la nouvelle SqlConnectionStringBuilder, qui valide la chaîne de connexion et permet d’éliminer ce problème.If you need to construct connection strings based on user input, use the new SqlConnectionStringBuilder, which validates the connection string and helps to eliminate this problem. Consultez générateurs de chaînes de connexion pour plus d’informations.See Connection String Builders for more information.

S’applique à

Voir aussi