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

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

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

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 un SqlConnection y establece el ConnectionString propiedad 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

El ConnectionString es similar a una cadena de conexión OLE DB, pero no es idéntico.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 el mismo que el establecido por el usuario ConnectionString, menos la información de seguridad si se establece el valor de Persist Security Info 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 conservar o devolver la contraseña de una cadena de conexión a menos que establezca 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.

Puede usar el ConnectionString propiedad 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.

El ConnectionString propiedad puede establecerse solo cuando se cierra la conexión.The ConnectionString property can be set only when the connection is closed. Muchos de los valores de cadena de conexión tienen propiedades correspondientes de solo lectura.Many of the connection string values have corresponding read-only properties. Cuando se establece la cadena de conexión, se actualizan estas propiedades, 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, ninguna de las propiedades se actualizan.In this case, none of the properties are updated. SqlConnection las propiedades devuelven únicamente los valores que se encuentran 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á una conexión a 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.

Restableciendo el ConnectionString en una conexión cerrada, restablece 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 se establece una cadena de conexión que incluye "base de datos = AdventureWorks" y, a continuación, restablece la cadena de conexión en "origen de datos = myserver; Integrated Security = true", el Database propiedad ya no está establecida 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 que se va a establecer.The connection string is parsed immediately after being set. Si se encuentran errores de sintaxis al analizar, una excepción en tiempo de ejecución, como ArgumentException, se genera.If errors in syntax are found when parsing, a runtime exception, such as ArgumentException, is generated. Otros errores se pueden encontrar sólo cuando se realiza un intento para 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 palabra clave-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 los valores que contienen un punto y coma, caracteres de comillas simples o carácter de comillas dobles, el valor debe incluirse 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 puede ir 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 empieza por un carácter de comillas dobles.The single quotation mark is also useful if the value starts with a double-quote character. Por el contrario, se puede usar las comillas dobles si el valor empieza 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 comillas dobles, se debe duplicar el carácter de comilla de cierre que se encierra el valor cada vez que se produzca en el 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 del principio o al finales del valor de cadena, el valor debe incluirse en comillas simples o dobles comillas.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 en torno a entero, booleano o valores enumerados, incluso si se incluyen 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 de literales de cadena o un valor.However, spaces within a string literal keyword or value are preserved. Las comillas simples o dobles puede utilizarse dentro de una cadena de conexión sin usar delimitadores (por ejemplo, el origen de datos = ' servidor o el origen de datos = mi servidor"), a menos que un carácter de comilla de cierre es el primer o ú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.

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

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

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

Nombre de una aplicación puede tener 128 caracteres o menos.An application name can be 128 characters or less.
ApplicationIntent ReadWrite Declara el tipo de carga de trabajo de 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
'false''false' Cuando true, habilita la compatibilidad con la operación asincrónica.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 para 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 El nombre del archivo de base de datos principal, incluido el nombre de ruta de acceso completa de una base de datos que se pueden 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 principal con una extensión. mdf.AttachDBFilename is only supported for primary data files with an .mdf extension.

Si se especifica el valor de la clave AttachDBFileName 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 la base de datos se ha adjuntado previamente, no se puede 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 adjunta anteriormente se usará como 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 adjunto, la conexión se producirá un error.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 utiliza DataDirectory, el archivo de base de datos debe existir dentro de un subdirectorio del directorio señalado por 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: Servidor remoto, HTTP y UNC no se admiten nombres de ruta de acceso.Note: Remote server, HTTP, and UNC path names are not supported.

Debe especificarse el nombre de la base de datos con la palabra clave 'database' (o uno de sus alias) como en el ejemplo siguiente: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 El método de autenticación utilizado para conectarse a SQL base de datos mediante Azure Active Directory la autenticación.The authentication method used for Connecting to SQL Database By Using Azure Active Directory Authentication.

Los valores válidos son:Valid values are:

Contraseña de Active Directory integrado, Active Directory, contraseña de Sql.Active Directory Integrated, Active Directory Password, Sql Password.
Configuración de cifrado de columnaColumn Encryption Setting N/DN/A Habilita o deshabilita Always Encrypted funcionalidad 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-

TimeoutTimeout
1515 El período de tiempo (en segundos) para esperar 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 mayores que o igual a 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 una base de datos de SQL Azure, establezca el tiempo de espera de 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 Los controles de número de reconexión intentos 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 0 y 255.Valid values are 0 to 255. El valor predeterminado es 1.The default is 1. 0 significa que no intente volver a conectar (deshabilitar resistencia de 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 artículo técnico: 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 1 y 60 segundos (valor predeterminado = 10), se aplica 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 inmediatamente volver a conectar; Éste 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 los intentos de reconexión de la segunda y posteriores.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 artículo técnico: resistencia de conexión inactiva.For additional information about idle connection resiliency, see Technical Article - Idle Connection Resiliency.
Conexión de contextoContext Connection 'false''false' true Si debe realizarse 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 mensajes de advertencia o error de servidor de base de datos.Sets the language used for database server warning or error messages.

El nombre del lenguaje puede tener 128 caracteres o menos.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-

AddrAddr

O bien-or-

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

server=tcp:servername, portnumber

Al especificar una instancia local, utilice 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 LocalDB como sigue: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 para LocalDB.For more information about LocalDB, see SqlClient Support for LocalDB.

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

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:" seguido de la instancia de base de datos, tal como se especifica mediante 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. Cuando se especifica ningún protocolo, se selecciona automáticamente TCP para las conexiones a Azure SQL Database.TCP is automatically selected for connections to Azure SQL Database when no protocol is specified.

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

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

El nombre de instancia se utiliza para resolver a un determinado número de puerto TCP/IP 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. Como alternativa, 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 ambos 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 seguida por 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 en una de las maneras siguientes:The host name MUST be specified in one of the following ways:

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

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

Si el valor de la red clave se especifica, los prefijos "tcp:" y "np:" no se debe especificar.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 memoria compartida, ya sea por un prefijo tcp: al nombre del servidor en la cadena de conexión, o mediante 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' Cuando true, SQL Server utiliza el cifrado SSL para todos los datos enviados entre el cliente y servidor si el servidor tiene instalado un certificado.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, consulte sintaxis de la 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 dirección IP) en un certificado SSL de SQL Server debe coincidir exactamente con el nombre de servidor (o 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 sobre la compatibilidad con certificados cuyo asunto empieza con un carácter comodín (*), consulte aceptan los comodines usados por los 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 incluye 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 El nombre del servidor asociado de conmutación por error donde se configura la creación de reflejo de base de datos.The name of the failover partner server where database mirroring is configured.

Si el valor de esta clave es "", a continuación, Initial Catalog 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 o menos.The server name can be 128 characters or less.

Si especifica un asociado de conmutación por error, pero el servidor asociado de conmutación por error no está configurado para la creación de reflejo de base de datos y el servidor principal (especificado con la palabra clave Server) no está disponible, a continuación, 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 base de datos, la conexión al servidor principal (especificado 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
'false''false' Cuando false, 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 utilizan las actuales credenciales de cuenta de Windows para la autenticación.When true, the current Windows account credentials are used for authentication.

Los valores reconocidos son true, false, yes, no, y sspi (muy recomendable), que es equivalente a true.Recognized values are true, false, yes, no, and sspi (strongly recommended), which is equivalent to true.

Si el identificador de usuario y contraseña se especifica y se integran seguridad está establecida en true, el identificador de usuario y contraseña se omitirá 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 para especificar las credenciales para una conexión que utiliza 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 El 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 de mayor o igual que 1.Valid values are greater than or equal to 1. Los valores que son menos de Min Pool Size generará un error.Values that are less than Min Pool Size generate an error.
Min Pool SizeMin Pool Size 00 El 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 de mayor o igual que 0.Valid values are greater than or equal to 0. Cero (0) en este campo significa que no hay conexiones mínimos inicialmente se abren.Zero (0) in this field means no minimum connections are initially opened.

Los valores que son mayores que Max Pool Size generará un error.Values that are greater than Max Pool Size generate an error.
MultipleActiveResultSetsMultipleActiveResultSets 'false''false' Cuando 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 conectar con el grupo de disponibilidad del agente de escucha de un SQL Server 2012 (o posterior) de grupo de disponibilidad o una instancia SQL Server 2012 (o posterior) conmutación por error de clúster.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 más rápida y conexión con el servidor (actualmente) activo.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 para siempre en AG, consulte 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-

NETNet
N/DN/A La 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 (Named Pipes)dbnmpntw (Named Pipes)

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

dbmsadsn (Apple Talk)dbmsadsn (Apple Talk)

dbmsgnet (VIA)dbmsgnet (VIA)

dbmslpcn (Shared Memory)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 utiliza 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 del paquete puede ser mayor o igual que 512 y menor o igual a 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 La contraseña de la cuenta de SQL Server, inicio de sesión.The password for the SQL Server account logging on. No se recomienda.Not recommended. Para mantener un alto nivel de seguridad, se recomienda encarecidamente que utilice el Integrated Security o Trusted_Connection palabra clave 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 para especificar las credenciales para una conexión que utiliza 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 128 caracteres o menos.The password must be 128 characters or less.
Persist Security InfoPersist Security Info

O bien-or-

PersistSecurityInfoPersistSecurityInfo
'false''false' Cuando se establece en false o no (muy recomendable), información 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. Restablecimiento de la cadena de conexión restablece 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 de 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, las recién creadas la conexión se agregará al grupo cuando cierra la aplicación.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 un próximo intento de abrir la misma conexión, se dibuja desde el grupo de esa conexión.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. Diferentes conexiones con cadenas de conexión diferentes.Different connections have different connection strings.

El valor de esta clave puede ser "true", "false", "Sí" o "no".The value of this key can be "true", "false", "yes", or "no".
ReplicaciónReplication 'false''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 un inscrito System.Transactions transacciones.Controls connection association with an enlisted System.Transactions transaction.

Los valores posibles son:Possible values are:

Transaction Binding=Implicit Unbind;

Transaction Binding=Explicit Unbind;

Desenlazar implícita 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 del uso de un bloque) antes de que finalice el último comando, producirá InvalidOperationException.If the system ends the transaction (in the scope of a using block) before the last command completes, it will throw InvalidOperationException.

Explícitas causas desenlazar la conexión permanezca conectada a la transacción hasta que la conexión está cerrada o explícita SqlConnection.TransactionEnlist(null) se llama.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, cambios para deshacer el enlace implícito que desenlace explícito 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 Consulte 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 el MultiSubnetFailover clave se establece en true, TransparentNetworkIPResolution se omite.If the MultiSubnetFailover key is set to true, TransparentNetworkIPResolution is ignored.

Si el Failover Partner clave está establecida, TransparentNetworkIPResolution se omite.If the Failover Partner key is set, TransparentNetworkIPResolution is ignored.

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

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

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

Los valores predeterminados son como sigue:The default values are as follows:

  • false Cuándo:false when:

    • Conectarse a Azure SQL Database donde finaliza el origen de datos con: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 'Contraseña de Active Directory' o 'Integrada de Active Directory'Authentication is 'Active Directory Password' or 'Active Directory Integrated'
  • true en todos los demás casos.true in all other cases.
TrustServerCertificateTrustServerCertificate 'false''false' Cuando se establece en true, se usa SSL para cifrar el canal cuando se omite recorrer 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, no se cifra el canal.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, consulte sintaxis de la cadena de conexión.For more information, see Connection String Syntax.
Versión del sistema de tipoType System Version N/DN/A Un 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: La versión del sistema de tipos no se puede establecer en 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, consulte integración Common Language Runtime de SQL Server.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 requerirá 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. El otro Type System Version configuración 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 La cuenta de inicio de sesión de SQL Server.The SQL Server login account. No se recomienda.Not recommended. Para mantener un alto nivel de seguridad, se recomienda encarecidamente que utilice el Integrated Security o Trusted_Connection palabras clave 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 para especificar las credenciales para una conexión que utiliza autenticación de SQL Server.SqlCredential is a more secure way to specify credentials for a connection that uses SQL Server Authentication.

El identificador de usuario debe tener 128 caracteres o menos.The user ID must be 128 characters or less.
Instancia de usuarioUser Instance 'false''false' Un valor que indica si se debe redirigir la conexión de la instancia de SQL Server Express predeterminada a una instancia iniciada por el tiempo de ejecución que se ejecutan 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
El 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 128 caracteres o menos.The ID must be 128 characters or less.

En la lista siguiente contiene los nombres válidos para los valores dentro de la agrupación de conexiones del 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

Al establecer la palabra clave o los valores que requieren un valor booleano de agrupación de conexiones, puede utilizar '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 ya 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

Archivos universal data link (UDL) no se admiten para 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 cuidado al construir una cadena de conexión basándose en la entrada de usuario (por ejemplo, al recuperar la información de identificador y la contraseña de usuario de un cuadro de diálogo y agregarla 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 incrustar 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 para adjuntar 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 de 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. Consulte generadores de cadenas de conexión para obtener más información.See Connection String Builders for more information.

Se aplica a

Consulte también: