SqlConnection.ConnectionString Propiedad

Definición

Obtiene o establece la cadena que se utiliza para abrir una base de datos de SQL Server.Gets or sets the string used to open a SQL Server database.

public:
 property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
[System.Data.DataSysDescription("SqlConnection_ConnectionString")]
[System.ComponentModel.SettingsBindable(true)]
public string ConnectionString { get; set; }
member this.ConnectionString : string with get, set
Public Property ConnectionString As String

Valor de propiedad

Cadena de conexión que incluye el nombre de la base de datos de origen y otros parámetros necesarios para establecer la conexión inicial.The connection string that includes the source database name, and other parameters needed to establish the initial connection. El valor predeterminado es una cadena vacía.The default value is an empty string.

Implementaciones

Atributos

Excepciones

Se proporcionó un argumento de la cadena de conexión no válido, o no se proporcionó un argumento de la cadena de conexión requerido.An invalid connection string argument has been supplied, or a required connection string argument has not been supplied.

Ejemplos

En el ejemplo siguiente se crea una SqlConnection y se establece la propiedad ConnectionString antes de abrir la conexión.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

Comentarios

La ConnectionString es similar a una cadena de conexión de OLE DB, pero no es idéntica.The ConnectionString is similar to an OLE DB connection string, but is not identical. A diferencia de OLE DB o ADO, la cadena de conexión que se devuelve es la misma que la ConnectionStringdel conjunto de usuarios, menos la información de seguridad si el valor de Persist Security info se establece en false (valor predeterminado).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). El proveedor de datos de .NET Framework para SQL Server no conserva o devuelve la contraseña en una cadena de conexión a menos que establezca Persist Security info en 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.

Puede usar la propiedad ConnectionString para conectarse a una base de datos.You can use the ConnectionString property to connect to a database. En el ejemplo siguiente se muestra una cadena de conexión típica.The following example illustrates a typical connection string.

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

Use la nueva SqlConnectionStringBuilder para construir cadenas de conexión válidas en tiempo de ejecución.Use the new SqlConnectionStringBuilder to construct valid connection strings at run time. Para obtener más información, vea Generadores de cadenas de conexión.For more information, see Connection String Builders.

La propiedad ConnectionString solo se puede establecer cuando la conexión está cerrada.The ConnectionString property can be set only when the connection is closed. Muchos de los valores de cadena de conexión tienen las propiedades de solo lectura correspondientes.Many of the connection string values have corresponding read-only properties. Cuando se establece la cadena de conexión, estas propiedades se actualizan, excepto cuando se detecta un error.When the connection string is set, these properties are updated, except when an error is detected. En este caso, no se actualiza ninguna de las propiedades.In this case, none of the properties are updated. SqlConnection propiedades solo devuelven los valores contenidos en el ConnectionString.SqlConnection properties return only those settings that are contained in the ConnectionString.

Para conectarse a un equipo local, especifique "(local)" para el servidor.To connect to a local computer, specify "(local)" for the server. Si no se especifica un nombre de servidor, se intentará establecer una conexión con la instancia predeterminada en el equipo local.If a server name is not specified, a connection will be attempted to the default instance on the local computer.

Al restablecer el ConnectionString en una conexión cerrada, se restablecen todos los valores de cadena de conexión (y las propiedades relacionadas) incluida la contraseña.Resetting the ConnectionString on a closed connection resets all connection string values (and related properties) including the password. Por ejemplo, si establece una cadena de conexión que incluya "Database = AdventureWorks" y, a continuación, restablece la cadena de conexión en "Data Source = mi Server; Integrated Security = true", la propiedad Database ya no se establece en "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 cadena de conexión se analiza inmediatamente después de su establecimiento.The connection string is parsed immediately after being set. Si se encuentran errores de sintaxis durante el análisis, se genera una excepción en tiempo de ejecución, como ArgumentException.If errors in syntax are found when parsing, a runtime exception, such as ArgumentException, is generated. Solo se pueden encontrar otros errores cuando se intenta abrir la conexión.Other errors can be found only when an attempt is made to open the connection.

El formato básico de una cadena de conexión incluye una serie de pares de palabra clave y valor separados por punto y coma.The basic format of a connection string includes a series of keyword/value pairs separated by semicolons. El signo igual (=) asocia cada palabra clave a su valor.The equal sign (=) connects each keyword and its value. Para incluir valores que contengan un punto y coma, un carácter de comilla simple o un carácter de comilla doble, el valor debe ir entre comillas dobles.To include values that contain a semicolon, single-quote character, or double-quote character, the value must be enclosed in double quotation marks. Si el valor contiene un punto y coma y un carácter de comillas dobles, el valor se puede incluir entre comillas simples.If the value contains both a semicolon and a double-quote character, the value can be enclosed in single quotation marks. La comilla simple también es útil si el valor comienza con un carácter de comilla doble.The single quotation mark is also useful if the value starts with a double-quote character. Por el contrario, se pueden usar comillas dobles si el valor comienza por una comilla simple.Conversely, the double quotation mark can be used if the value starts with a single quotation mark. Si el valor contiene caracteres de comillas simples y dobles, el carácter de comillas que se usa para incluir el valor se debe duplicar cada vez que se produzca dentro del valor.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.

Para incluir espacios anteriores o finales en el valor de cadena, el valor debe estar entre comillas simples o comillas dobles.To include preceding or trailing spaces in the string value, the value must be enclosed in either single quotation marks or double quotation marks. Se omiten los espacios iniciales o finales alrededor de los valores enteros, booleanos o enumerados, incluso si están entre comillas.Any leading or trailing spaces around integer, Boolean, or enumerated values are ignored, even if enclosed in quotation marks. Sin embargo, se conservan los espacios dentro de una palabra clave o un valor de literal de cadena.However, spaces within a string literal keyword or value are preserved. Las comillas simples o dobles se pueden usar dentro de una cadena de conexión sin usar delimitadores (por ejemplo, Data Source = my'Server o Data Source = My "Server), a menos que el carácter de Comillas sea el primer o el último carácter del valor.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.

Las palabras clave no distinguen mayúsculas de minúsculas.Keywords are not case sensitive.

En la tabla siguiente se enumeran los nombres válidos para los valores de palabra clave en el ConnectionString.The following table lists the valid names for keyword values within the ConnectionString.

Palabra claveKeyword DefaultDefault DescripciónDescription
RangoAddr N/DN/A Sinónimo del origen de datos.Synonym of Data Source.
DirecciónAddress N/DN/A Sinónimo del origen de datos.Synonym of Data Source.
AplicaciónApp N/DN/A Sinónimo del nombrede la aplicación.Synonym of Application Name.
Nombre de la aplicaciónApplication Name N/DN/A El nombre de la aplicación o "proveedor de datos SQLClient de .NET" si no se proporciona ningún nombre de aplicación.The name of the application, or '.NET SQLClient Data Provider' if no application name is provided.

Un nombre de aplicación puede tener 128 caracteres como máximo.An application name can be 128 characters or less.
ApplicationIntent ReadWrite Declara el tipo de carga de trabajo de la aplicación al conectarse a un servidor.Declares the application workload type when connecting to a server. Los valores posibles son ReadOnly y ReadWrite.Possible values are ReadOnly and ReadWrite. Por ejemplo:For example:

ApplicationIntent=ReadOnly

Para obtener más información sobre la compatibilidad de SqlClient con grupos de disponibilidad AlwaysOn, vea Compatibilidad de SqlClient para alta disponibilidad y recuperación ante desastres.For more information about SqlClient support for Always On Availability Groups, see SqlClient Support for High Availability, Disaster Recovery.
Procesamiento asincrónicoAsynchronous Processing

o bien-or-

AsyncAsync
es'false' Cuando true, habilita la compatibilidad con operaciones asincrónicas.When true, enables asynchronous operation support. Los valores reconocidos son true, false, yes y no.Recognized values are true, false, yes, and no.

Esta propiedad se omite si comienza con .NET Framework 4.5.NET Framework 4.5.This property is ignored beginning in .NET Framework 4.5.NET Framework 4.5. Para obtener más información sobre la compatibilidad de SqlClient con la programación asincrónica, vea programación asincrónica.For more information about SqlClient support for asynchronous programming, see Asynchronous Programming.
AttachDBFilenameAttachDBFilename

o bien-or-

Propiedades extendidasExtended Properties

o bien-or-

Nombre de archivo inicialInitial File Name
N/DN/A Nombre del archivo de base de datos principal, incluido el nombre completo de la ruta de acceso de una base de datos que se va a adjuntar.The name of the primary database file, including the full path name of an attachable database. AttachDBFilename solo se admite para los archivos de datos principales con una extensión. MDF.AttachDBFilename is only supported for primary data files with an .mdf extension.

Si el valor de la clave AttachDBFileName se especifica en la cadena de conexión, la base de datos se adjunta y se convierte en la base de datos predeterminada para la conexión.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 no se especifica esta clave y si la base de datos se ha adjuntado previamente, no se volverá a adjuntar la base de datos.If this key is not specified and if the database was previously attached, the database will not be reattached. La base de datos adjuntada previamente se utilizará como la base de datos predeterminada para la conexión.The previously attached database will be used as the default database for the connection.

Si esta clave se especifica junto con la clave AttachDBFileName, el valor de esta clave se usará como alias.If this key is specified together with the AttachDBFileName key, the value of this key will be used as the alias. Sin embargo, si el nombre ya se usa en otra base de datos adjunta, se producirá un error en la conexión.However, if the name is already used in another attached database, the connection will fail.

La ruta de acceso puede ser absoluta o relativa mediante el uso de la cadena de sustitución DataDirectory.The path may be absolute or relative by using the DataDirectory substitution string. Si se usa DataDirectory, el archivo de base de datos debe existir en un subdirectorio del directorio al que apunta la cadena de sustitución.If DataDirectory is used, the database file must exist within a subdirectory of the directory pointed to by the substitution string. Nota: No se admiten los nombres de ruta de acceso UNC, HTTP y de servidor remoto.Note: Remote server, HTTP, and UNC path names are not supported.

El nombre de la base de datos debe especificarse con la palabra clave ' Database ' (o uno de sus alias) como se indica a continuación: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"

Se generará un error si existe un archivo de registro en el mismo directorio que el archivo de datos y se utiliza la palabra clave 'database' al adjuntar el archivo de datos primario.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. En este caso, se debe quitar el archivo de registro.In this case, remove the log file. Una vez la base de datos has sido asociada, se generará automáticamente un nuevo archivo de registro basado en la ruta de acceso física.Once the database is attached, a new log file will be automatically generated based on the physical path.
AutenticaciónAuthentication N/DN/A Método de autenticación utilizado para conectarse a SQL Databasemediante la autenticación de Azure Active Directory.The authentication method used for Connecting to SQL Database By Using Azure Active Directory Authentication.

Los valores válidos son:Valid values are:

Active Directory integrada Active Directory contraseña, la contraseña de SQL.Active Directory Integrated, Active Directory Password, Sql Password.
Configuración de cifrado de columnasColumn Encryption Setting N/DN/A Habilita o deshabilita la funcionalidad de Always Encrypted para la conexión.Enables or disables Always Encrypted functionality for the connection.
Tiempo de espera de conexiónConnect Timeout

o bien-or-

Tiempo de espera de conexiónConnection Timeout

o bien-or-

Tiempo de esperaTimeout
1515 Período de tiempo (en segundos) que se debe esperar para una conexión al servidor antes de terminar el intento y generar un error.The length of time (in seconds) to wait for a connection to the server before terminating the attempt and generating an error.

Los valores válidos son mayor o igual que 0 y menor o igual que 2147483647.Valid values are greater than or equal to 0 and less than or equal to 2147483647.

Al abrir una conexión a un Azure SQL Database, establezca el tiempo de espera de la conexión en 30 segundos.When opening a connection to a Azure SQL Database, set the connection timeout to 30 seconds.
Duración de la conexiónConnection Lifetime

o bien-or-

Tiempo de espera de equilibrio de cargaLoad Balance Timeout
00 Cuando una conexión se devuelve al grupo, su hora de creación se compara con la hora actual y, si ese marco temporal (en segundos) supera el valor especificado por Connection Lifetime, la conexión se destruye.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. Esto resulta de utilidad en configuraciones agrupadas para forzar el equilibrio de carga entre un servidor en ejecución y uno que acaba de conectarse.This is useful in clustered configurations to force load balancing between a running server and a server just brought online.

Un valor de cero (0) hace que las conexiones agrupadas tengan el tiempo de espera de conexión máximo.A value of zero (0) causes pooled connections to have the maximum connection timeout.
ConnectRetryCountConnectRetryCount 11 Controla el número de intentos de reconexión después de que el cliente identifique un error de conexión inactiva.Controls the number of reconnection attempts after the client identifies an idle connection failure. Los valores válidos son de 0 a 255.Valid values are 0 to 255. El valor predeterminado es 1.The default is 1. 0 significa no intentar volver a conectarse (deshabilitar la resistencia de la conexión).0 means do not attempt to reconnect (disable connection resiliency).

Para obtener más información sobre la resistencia de conexión inactiva, consulte el artículo técnico sobre la resistencia de conexión inactiva.For additional information about idle connection resiliency, see Technical Article - Idle Connection Resiliency.
ConnectRetryIntervalConnectRetryInterval 1010 Especifica el tiempo entre cada reintento de conexión (ConnectRetryCount).Specifies the time between each connection retry attempt (ConnectRetryCount). Los valores válidos son de 1 a 60 segundos (valor predeterminado = 10), aplicados después del primer intento de reconexión.Valid values are 1 to 60 seconds (default=10), applied after the first reconnection attempt. Cuando se detecta una conexión interrumpida, el cliente intenta volver a conectarse inmediatamente. Este es el primer intento de reconexión y solo se produce si ConnectRetryCount es mayor que 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 se produce un error en el primer intento de reconexión y ConnectRetryCount es mayor que 1, el cliente espera ConnectRetryInterval para probar el segundo y los sucesivos intentos de reconexión.If the first reconnection attempt fails and ConnectRetryCount is greater than 1, the client waits ConnectRetryInterval to try the second and subsequent reconnection attempts.

Para obtener más información sobre la resistencia de conexión inactiva, consulte el artículo técnico sobre la resistencia de conexión inactiva.For additional information about idle connection resiliency, see Technical Article - Idle Connection Resiliency.
Conexión de contextoContext Connection es'false' true si se debe realizar una conexión en proceso con SQL Server.true if an in-process connection to SQL Server should be made.
Idioma actualCurrent Language

O bien-or-

LenguajeLanguage
N/DN/A Establece el idioma usado para los mensajes de error o de advertencia del servidor de base de datos.Sets the language used for database server warning or error messages.

El nombre de idioma puede tener 128 caracteres como máximo.The language name can be 128 characters or less.
Origen de datosData Source

o bien-or-

ServidorServer

o bien-or-

DirecciónAddress

o bien-or-

RangoAddr

O bien-or-

Dirección de redNetwork Address
N/DN/A El nombre o la dirección de red de la instancia de SQL Server a la que se va a conectar.The name or network address of the instance of SQL Server to which to connect. El número de puerto puede especificarse después del nombre del servidor:The port number can be specified after the server name:

server=tcp:servername, portnumber

Al especificar una instancia local, use siempre (local).When specifying a local instance, always use (local). Para forzar un protocolo, agregue uno de los siguientes prefijos:To force a protocol, add one of the following prefixes:

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

A partir de .NET Framework 4.5.NET Framework 4.5, también puede conectarse a una base de datos de LocalDB de la siguiente manera:Beginning in .NET Framework 4.5.NET Framework 4.5, you can also connect to a LocalDB database as follows:

server=(localdb)\\myInstance

Para obtener más información acerca de LocalDB, vea compatibilidad de SqlClient con LocalDB.For more information about LocalDB, see SqlClient Support for LocalDB.

El origen de datos debe usar el formato TCP o el formato de canalizaciones con nombre.Data Source must use the TCP format or the Named Pipes format.

El formato TCP es el siguiente:TCP format is as follows:

-TCP:<nombre de host >\< nombre de instancia>- tcp:<host name>\<instance name>
-TCP:<nombre de host >,<número de puerto TCP/IP >- tcp:<host name>,<TCP/IP port number>

El formato TCP debe comenzar con el prefijo "TCP:" y va seguido de la instancia de base de datos, tal y como se especifica en un nombre de host y un nombre de instancia.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. Este formato no es aplicable cuando se conecta a Azure SQL Database.This format is not applicable when connecting to Azure SQL Database. TCP se selecciona automáticamente para las conexiones a Azure SQL Database cuando no se especifica ningún protocolo.TCP is automatically selected for connections to Azure SQL Database when no protocol is specified.

El nombre de host debe especificarse de una de las siguientes maneras:The host name MUST be specified in one of the following ways:

- NetBIOSName- NetBIOSName
-Direcciónipv4- IPv4Address
-Direcciónipv6- IPv6Address

El nombre de instancia se utiliza para resolver un número de puerto TCP/IP determinado en el que se hospeda una instancia de base de datos.The instance name is used to resolve to a particular TCP/IP port number on which a database instance is hosted. También se permite especificar un número de puerto TCP/IP directamente.Alternatively, specifying a TCP/IP port number directly is also allowed. Si el nombre de instancia y el número de puerto no están presentes, se usa la instancia de base de datos predeterminada.If both instance name and port number are not present, the default database instance is used.

El formato de canalizaciones con nombre es el siguiente:The Named Pipes format is as follows:

-NP:\\< nombre de host>\pipe\< nombre de canalización>- np:\\<host name>\pipe\<pipe name>

El formato de canalizaciones con nombre debe comenzar con el prefijo "NP:" y va seguido de un nombre de canalización con nombre.The Named Pipes format MUST start with the prefix "np:" and is followed by a named pipe name.

El nombre de host debe especificarse de una de las siguientes maneras:The host name MUST be specified in one of the following ways:

- NetBIOSName- NetBIOSName
-Direcciónipv4- IPv4Address
-Direcciónipv6- IPv6Address

El nombre de la canalización se utiliza para identificar la instancia de base de datos a la que se conectará la aplicación .NET Framework.The pipe name is used to identify the database instance to which the .NET Framework application will be connected.

Si se especifica el valor de la clave de red , no se deben especificar los prefijos "TCP:" y "NP:".If the value of the Network key is specified, the prefixes "tcp:" and "np:" should not be specified. Nota: Puede forzar el uso de TCP en lugar de la memoria compartida, ya sea mediante el prefijo de TCP: en el nombre de servidor en la cadena de conexión o mediante el uso de 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 es'false' Cuando true, SQL Server usa el cifrado SSL para todos los datos enviados entre el cliente y el servidor si el servidor tiene un certificado instalado.When true, SQL Server uses SSL encryption for all data sent between the client and server if the server has a certificate installed. Los valores reconocidos son true, false, yes y no.Recognized values are true, false, yes, and no. Para obtener más información, vea Sintaxis de cadena de conexión.For more information, see Connection String Syntax.

A partir de .NET Framework 4.5.NET Framework 4.5, cuando TrustServerCertificate es false y Encrypt es true, el nombre del servidor (o la dirección IP) de un certificado SSL SQL Server debe coincidir exactamente con el nombre del servidor (o la dirección IP) especificado en la cadena de conexión.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. De lo contrario, se producirá un error en el intento de conexión.Otherwise, the connection attempt will fail. Para obtener información acerca de la compatibilidad con certificados cuyo asunto comienza con un carácter comodín (*), consulte caracteres comodín aceptados usados por certificados de servidor para la autenticación de servidor.For information about support for certificates whose subject starts with a wildcard character (*), see Accepted wildcards used by server certificates for server authentication.
Dar de altaEnlist 'true''true' true indica que el agrupador de conexiones de SQL Server da de alta automáticamente la conexión en el contexto de transacción actual del subproceso de creación.true indicates that the SQL Server connection pooler automatically enlists the connection in the creation thread's current transaction context.
Socio de conmutación por errorFailover Partner N/DN/A Nombre del servidor asociado de conmutación por error en el que está configurada la creación de reflejo de la base de datos.The name of the failover partner server where database mirroring is configured.

Si el valor de esta clave es "", el catálogo inicial debe estar presente y su valor no debe ser "".If the value of this key is "", then Initial Catalog must be present, and its value must not be "".

El nombre del servidor puede tener 128 caracteres como máximo.The server name can be 128 characters or less.

Si especifica un asociado de conmutación por error, pero el servidor del asociado de conmutación por error no está configurado para la creación de reflejo de la base de datos y el servidor principal (especificado con la palabra clave Server) no está disponible, se producirá un error en la conexión.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 especifica un asociado de conmutación por error y el servidor principal no está configurado para la creación de reflejo de la base de datos, la conexión al servidor principal (especificada con la palabra clave Server) se realizará correctamente si el servidor 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.
Catálogo originalInitial Catalog

O bien-or-

Base de datosDatabase
N/DN/A El nombre de la base de datos.The name of the database.

El nombre de la base de datos puede tener 128 caracteres o menos.The database name can be 128 characters or less.
Seguridad integradaIntegrated Security

o bien-or-

Trusted_ConnectionTrusted_Connection
es'false' Cuando false, el ID. de usuario y la contraseña se especifican en la conexión.When false, User ID and Password are specified in the connection. Cuando true, se usan las credenciales de la cuenta de Windows actual para la autenticación.When true, the current Windows account credentials are used for authentication.

Los valores reconocidos son true, false, yes, noy sspi (se recomienda encarecidamente), que es equivalente a true.Recognized values are true, false, yes, no, and sspi (strongly recommended), which is equivalent to true.

Si se especifican el identificador de usuario y la contraseña y la seguridad integrada está establecida en true, se omitirá el identificador de usuario y la contraseña y se usará la seguridad integrada.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 es una forma más segura de especificar las credenciales de una conexión que utiliza la autenticación de 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 Número máximo de conexiones permitidas en el grupo.The maximum number of connections that are allowed in the pool.

Los valores válidos son mayores o iguales que 1.Valid values are greater than or equal to 1. Los valores menores que el tamaño mínimo del grupo generan un error.Values that are less than Min Pool Size generate an error.
Min Pool SizeMin Pool Size 00 Número mínimo de conexiones permitidas en el grupo.The minimum number of connections that are allowed in the pool.

Los valores válidos son mayores o iguales que 0.Valid values are greater than or equal to 0. Cero (0) en este campo significa que no se abren inicialmente conexiones mínimas.Zero (0) in this field means no minimum connections are initially opened.

Los valores mayores que el tamaño máximo del grupo generan un error.Values that are greater than Max Pool Size generate an error.
MultipleActiveResultSetsMultipleActiveResultSets es'false' Cuando se true, una aplicación puede mantener conjuntos de resultados activos múltiples (MARS).When true, an application can maintain multiple active result sets (MARS). Cuando false, una aplicación debe procesar o cancelar todos los conjuntos de resultados de un lote antes de poder ejecutar cualquier otro lote en esa conexión.When false, an application must process or cancel all result sets from one batch before it can execute any other batch on that connection.

Los valores reconocidos son true y false.Recognized values are true and false.

Para obtener más información, consulte Conjuntos de resultados activos múltiples (MARS).For more information, see Multiple Active Result Sets (MARS).
MultiSubnetFailover falseFALSE Especifique siempre multiSubnetFailover=True al conectarse al agente de escucha del grupo de disponibilidad de un grupo de disponibilidad de SQL Server 2012 (o posterior) o una instancia de clúster de conmutación por error de SQL Server 2012 (o posterior).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 configura SqlClient para proporcionar una detección y conexión más rápidas al servidor activo (actualmente).multiSubnetFailover=True configures SqlClient to provide faster detection of and connection to the (currently) active server. Los valores posibles son Yes y No, True y False o 1 y 0.Possible values are Yes and No, True and False or 1 and 0. Por ejemplo:For example:

MultiSubnetFailover=True

De manera predeterminada, es False.The default is False. Para obtener más información sobre la compatibilidad de SqlClient con Always On AG, vea compatibilidad de SqlClient para alta disponibilidad y recuperación ante desastres.For more information about SqlClient's support for Always On AGs, see SqlClient Support for High Availability, Disaster Recovery.
Biblioteca de redNetwork Library

o bien-or-

RedNetwork

o bien-or-

SaldNet
N/DN/A Biblioteca de red utilizada para establecer una conexión a una instancia de SQL Server.The network library used to establish a connection to an instance of SQL Server. Los valores admitidos son:Supported values include:

DBNMPNTW (canalizaciones con nombre)dbnmpntw (Named Pipes)

dbmsrpcn (multiprotocolo, Windows RPC)dbmsrpcn (Multiprotocol, Windows RPC)

dbmsadsn (Apple Talk)dbmsadsn (Apple Talk)

dbmsgnet (VIA)dbmsgnet (VIA)

dbmslpcn (memoria compartida)dbmslpcn (Shared Memory)

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

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

Dbmsvinn (Banyan Vines)Dbmsvinn (Banyan Vines)

El DLL de red correspondiente debe estar instalado en el sistema al que se conecte.The corresponding network DLL must be installed on the system to which you connect. Si no especifica una red y usa un servidor local (por ejemplo, "." o "(local)"), se usa la memoria compartida.If you do not specify a network and you use a local server (for example, "." or "(local)"), shared memory is used. En este ejemplo, la biblioteca de red es Win32 Winsock TCP/IP (dbmssocn), y 1433 es el puerto que se está utilizando.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;
Tamaño de paquetePacket Size 80008000 Tamaño en bytes de los paquetes de red utilizados para comunicarse con una instancia de SQL Server.Size in bytes of the network packets used to communicate with an instance of SQL Server.

El tamaño de paquete puede ser mayor o igual que 512 y menor o igual que 32768.The packet size can be greater than or equal to 512 and less than or equal to 32768.
ContraseñaPassword

o bien-or-

PWDPWD
N/DN/A Contraseña de la cuenta de SQL Server que inicia sesión.The password for the SQL Server account logging on. No recomendado.Not recommended. Para mantener un alto nivel de seguridad, se recomienda encarecidamente que use la palabra clave Integrated Security o Trusted_Connection en su lugar.To maintain a high level of security, we strongly recommend that you use the Integrated Security or Trusted_Connection keyword instead. SqlCredential es una forma más segura de especificar las credenciales de una conexión que utiliza la autenticación de SQL Server.SqlCredential is a more secure way to specify credentials for a connection that uses SQL Server Authentication.

La contraseña debe tener entre 128 caracteres y menos.The password must be 128 characters or less.
Persist Security InfoPersist Security Info

o bien-or-

PersistSecurityInfoPersistSecurityInfo
es'false' Cuando se establece en false o no (se recomienda encarecidamente), la información confidencial de seguridad, como la contraseña, no se devuelve como parte de la conexión si la conexión está abierta o alguna vez ha estado abierta.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. Al restablecer la cadena de conexión, se restablecen todos los valores de cadena de conexión, incluida la contraseña.Resetting the connection string resets all connection string values including the password. Los valores reconocidos son true, false, yes y no.Recognized values are true, false, yes, and no.
PoolBlockingPeriodPoolBlockingPeriod AutomáticoAuto Establece el comportamiento del período de bloqueo para un grupo de conexiones.Sets the blocking period behavior for a connection pool. Consulte PoolBlockingPeriod propiedad para obtener más información.See PoolBlockingPeriod property for details.
AgrupaciónPooling 'true''true' Cuando el valor de esta clave se establece en true, cualquier conexión recién creada se agregará al grupo cuando la aplicación la cierre.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. En el siguiente intento de abrir la misma conexión, la conexión se dibujará desde el grupo.In a next attempt to open the same connection, that connection will be drawn from the pool.

Las conexiones se consideran iguales si tienen la misma cadena de conexión.Connections are considered the same if they have the same connection string. Las distintas conexiones tienen cadenas de conexión diferentes.Different connections have different connection strings.

El valor de esta clave puede ser "true", "false", "Yes" o "no".The value of this key can be "true", "false", "yes", or "no".
ReplicaciónReplication es'false' true si se admite la replicación mediante la conexión.true if replication is supported using the connection.
Enlace por transaccionesTransaction Binding Desenlace implícitoImplicit Unbind Controla la Asociación de la conexión con una transacción System.Transactions dada de alta.Controls connection association with an enlisted System.Transactions transaction.

Los valores posibles son:Possible values are:

Transaction Binding=Implicit Unbind;

Transaction Binding=Explicit Unbind;

El desenlace implícito hace que la conexión se desasocie de la transacción cuando termina.Implicit Unbind causes the connection to detach from the transaction when it ends. Después de la separación, las solicitudes adicionales en la conexión son ejecutadas en modo de confirmación automática.After detaching, additional requests on the connection are performed in autocommit mode. La propiedad System.Transactions.Transaction.Current no es comprobada al ejecutar solicitudes mientras la trasacción esté activa.The System.Transactions.Transaction.Current property is not checked when executing requests while the transaction is active. Después que la transacción se haya completado, las solicitudes adicionales en la conexión son ejecutadas en modo de confirmación automática.After the transaction has ended, additional requests are performed in autocommit mode.

Si el sistema finaliza la transacción (en el ámbito de un bloque Using) antes de que se complete el último comando, se iniciará InvalidOperationException.If the system ends the transaction (in the scope of a using block) before the last command completes, it will throw InvalidOperationException.

El desenlace explícito hace que la conexión permanezca adjuntada a la transacción hasta que se cierre la conexión o se llame a una SqlConnection.TransactionEnlist(null) explícita.Explicit Unbind causes the connection to remain attached to the transaction until the connection is closed or an explicit SqlConnection.TransactionEnlist(null) is called. A partir de .NET Framework 4.NET Framework 4, los cambios en el desenlace implícito hacen que el desenlace explícito quede obsoleto.Beginning in .NET Framework 4.NET Framework 4, changes to Implicit Unbind make Explicit Unbind obsolete. Se iniciará una InvalidOperationException si Transaction.Current no es la transacción dada de alta o si la transacción dada de alta no está activa.An InvalidOperationException is thrown if Transaction.Current is not the enlisted transaction or if the enlisted transaction is not active.
TransparentNetworkIPResolutionTransparentNetworkIPResolution Vea la descripción.See description. Cuando el valor de esta clave se establece en true, se requiere que la aplicación recupere todas las direcciones IP de una determinada entrada DNS e intente conectarse a la primera de la lista.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 conexión no se establece en 0,5 segundos, la aplicación intentará conectarse a todas las demás en paralelo.If the connection is not established within 0.5 seconds, the application will try to connect to all others in parallel. Cuando la primera responda, la aplicación establecerá la conexión con la dirección IP encuestada.When the first answers, the application will establish the connection with the respondent IP address.

Si la clave de MultiSubnetFailover está establecida en true, TransparentNetworkIPResolution se pasa por alto.If the MultiSubnetFailover key is set to true, TransparentNetworkIPResolution is ignored.

Si se establece la tecla Failover Partner, se omite TransparentNetworkIPResolution.If the Failover Partner key is set, TransparentNetworkIPResolution is ignored.

El valor de esta clave debe ser true, false, yeso no.The value of this key must be true, false, yes, or no.

Un valor de yes se trata igual que un valor de true.A value of yes is treated the same as a value of true.

Un valor de no se trata igual que un valor de false.A value of no is treated the same as a value of false.

Los valores predeterminados son los siguientes:The default values are as follows:

  • false cuando:false when:

    • Conectarse a Azure SQL Database donde finaliza el origen de datos: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 es ' Active Directory contraseña ' o ' Active Directory integrada 'Authentication is 'Active Directory Password' or 'Active Directory Integrated'
  • true en todos los demás casos.true in all other cases.
TrustServerCertificateTrustServerCertificate es'false' Cuando se establece en true, se usa SSL para cifrar el canal al omitir el recorrido de la cadena de certificados para validar la confianza.When set to true, SSL is used to encrypt the channel when bypassing walking the certificate chain to validate trust. Si TrustServerCertificate se establece en true y Encrypt se establece en false, el canal no se cifra.If TrustServerCertificate is set to true and Encrypt is set to false, the channel is not encrypted. Los valores reconocidos son true, false, yes y no.Recognized values are true, false, yes, and no. Para obtener más información, vea Sintaxis de cadena de conexión.For more information, see Connection String Syntax.
Versión del sistema de tiposType System Version N/DN/A Valor de cadena que indica el sistema de tipos que espera la aplicación.A string value that indicates the type system the application expects. La funcionalidad disponible en las aplicaciones cliente depende de la versión de SQL Server y del nivel de compatibilidad de la base de datos.The functionality available to a client application is dependent on the version of SQL Server and the compatibility level of the database. Establecer explícitamente la versión del sistema de tipos para la que se escribió la aplicación cliente evita posibles problemas que provocarían la interrupción de una aplicación si se utilizase una versión de SQL Server distinta.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. Nota: No se puede establecer la versión del sistema de tipos para el código Common Language Runtime (CLR) que se ejecuta en proceso en SQL Server.Note: The type system version cannot be set for common language runtime (CLR) code executing in-process in SQL Server. Para obtener más información, vea SQL Server integración de Common Language Runtime.For more information, see SQL Server Common Language Runtime Integration.

Los valores posibles son: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; especifica que la aplicación necesitará la versión 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. La otra configuración de Type System Version requerirá la versión 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á obsoleto y no debe usarse.Latest is obsolete and should not be used. Latest es equivalente a Type System Version=SQL Server 2008;.Latest is equivalent to Type System Version=SQL Server 2008;.
Id. de usuarioUser ID

O bien-or-

UIDUID

O bien-or-
N/DN/A SQL Server cuenta de inicio de sesión.The SQL Server login account. No recomendado.Not recommended. Para mantener un alto nivel de seguridad, se recomienda encarecidamente usar las palabras clave Integrated Security o Trusted_Connection en su lugar.To maintain a high level of security, we strongly recommend that you use the Integrated Security or Trusted_Connection keywords instead. SqlCredential es una forma más segura de especificar las credenciales de una conexión que utiliza la autenticación de SQL Server.SqlCredential is a more secure way to specify credentials for a connection that uses SQL Server Authentication.

El ID. de usuario debe tener entre 128 caracteres y menos.The user ID must be 128 characters or less.
Instancia de usuarioUser Instance es'false' Valor que indica si se debe redirigir la conexión de la instancia de SQL Server Express predeterminada a una instancia iniciada en tiempo de ejecución que se ejecuta en la cuenta del llamador.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

o bien-or-

WSIDWSID
Nombre del equipo localThe local computer name El nombre de la estación de trabajo que se conecta a SQL Server.The name of the workstation connecting to SQL Server.

El identificador debe tener entre 128 caracteres y menos.The ID must be 128 characters or less.

La lista siguiente contiene los nombres válidos para los valores de agrupación de conexiones en el ConnectionString.The following list contains the valid names for connection pooling values within the ConnectionString. Para obtener más información, vea Agrupación de conexiones de SQL Server (ADO.NET).For more information, see SQL Server Connection Pooling (ADO.NET).

  • Duración de la conexión (o tiempo de espera de equilibrio de carga)Connection Lifetime (or Load Balance Timeout)

  • Dar de altaEnlist

  • Max Pool SizeMax Pool Size

  • Min Pool SizeMin Pool Size

  • AgrupaciónPooling

Cuando se establece la palabra clave o los valores de agrupación de conexiones que requieren un valor booleano, se puede usar ' Yes ' en lugar de ' true ' y ' no ' en lugar 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'. Los valores enteros se representan como cadenas.Integer values are represented as strings.

Nota

El proveedor de datos de .NET Framework para SQL Server usa su propio protocolo para comunicarse con SQL Server.The .NET Framework Data Provider for SQL Server uses its own protocol to communicate with SQL Server. Por lo tanto, no admite el uso de un nombre de origen de datos ODBC (DSN) al conectarse a SQL Server porque no agrega una capa 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.

Nota

Los archivos de vínculo de datos universal (UDL) no son compatibles con el proveedor de datos de .NET Framework para SQL Server.Universal data link (UDL) files are not supported for the .NET Framework Data Provider for SQL Server.

Precaución

En esta versión, la aplicación debe tener precaución al construir una cadena de conexión basada en la entrada del usuario (por ejemplo, al recuperar la información de identificador de usuario y contraseña de un cuadro de diálogo y anexarla a la cadena de conexión).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). La aplicación debe asegurarse de que un usuario no puede insertar parámetros de cadena de conexión adicionales en estos valores (por ejemplo, si escribe una contraseña como "validpassword; Database = somedb" en un intento de asociarse a una base de datos diferente).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 necesita construir cadenas de conexión basadas en la entrada del usuario, use la nueva SqlConnectionStringBuilder, que valida la cadena de conexión y ayuda a eliminar este problema.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. Vea compiladores de cadenas de conexión para obtener más información.See Connection String Builders for more information.

Se aplica a

Consulte también: