SqlConnection.ConnectionString Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece la cadena que se utiliza para abrir una base de datos de SQL Server.
public:
virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
public:
property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
public override string ConnectionString { get; set; }
[System.Data.DataSysDescription("SqlConnection_ConnectionString")]
public string ConnectionString { get; set; }
[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }
member this.ConnectionString : string with get, set
[<System.Data.DataSysDescription("SqlConnection_ConnectionString")>]
member this.ConnectionString : string with get, set
[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set
Public Overrides Property ConnectionString As String
Public Property ConnectionString As String
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. El valor predeterminado es una cadena vacía.
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.
Ejemplos
En el ejemplo siguiente se crea y SqlConnection se establece la ConnectionString propiedad antes de abrir la conexión.
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
ConnectionString es similar a un cadena de conexión OLE DB, pero no es idéntico. A diferencia de OLE DB o ADO, el cadena de conexión que se devuelve es el mismo que el establecido ConnectionStringpor el usuario, menos la información de seguridad si el valor persistir información de seguridad está establecido false
en (valor predeterminado). El proveedor de datos de .NET Framework para SQL Server no conserva ni devuelve la contraseña en un cadena de conexión a menos que establezca Persist Security Info true
en .
Puede usar la ConnectionString propiedad para conectarse a una base de datos. En el ejemplo siguiente se muestra un cadena de conexión típico.
"Persist Security Info=False;Integrated Security=true;Initial Catalog=Northwind;server=(local)"
Use el nuevo SqlConnectionStringBuilder para construir cadenas de conexión válidas en tiempo de ejecución. Para obtener más información, vea Generadores de cadenas de conexión.
La ConnectionString propiedad solo se puede establecer cuando se cierra la conexión. Muchos de los valores de cadena de conexión tienen las propiedades de solo lectura correspondientes. Cuando se establece el cadena de conexión, estas propiedades se actualizan, excepto cuando se detecta un error. En este caso, no se actualiza ninguna de las propiedades. SqlConnectionlas propiedades devuelven solo las configuraciones contenidas en .ConnectionString
Para conectarse a un equipo local, especifique "(local)" para el servidor. Si no se especifica un nombre de servidor, se intentará una conexión a la instancia predeterminada en el equipo local.
Al restablecer en ConnectionString una conexión cerrada, se restablecen todos los valores de cadena de conexión (y las propiedades relacionadas), incluida la contraseña. Por ejemplo, si establece un cadena de conexión que incluye "Database= AdventureWorks" y, a continuación, restablece el cadena de conexión en "Data Source=myserver; Integrated Security=true", la Database propiedad ya no está establecida en "AdventureWorks".
El cadena de conexión se analiza inmediatamente después de establecerse. Si se encuentran errores en la sintaxis al analizar, se genera una excepción en tiempo de ejecución, como ArgumentException, . Solo se pueden encontrar otros errores cuando se intenta abrir la conexión.
El formato básico de un cadena de conexión incluye una serie de pares de palabra clave-valor separados por punto y coma. El signo igual (=) asocia cada palabra clave a su valor. Para incluir valores que contienen un punto y coma, un carácter de comillas simples o un carácter de comillas dobles, el valor debe ir entre comillas dobles. Si el valor contiene un punto y coma y un carácter de comillas dobles, el valor se puede incluir entre comillas simples. La comilla simple también es útil si el valor comienza con un carácter de comilla doble. Por el contrario, se puede usar la comilla doble si el valor comienza con una comilla simple. Si el valor contiene caracteres de comillas simples y comillas dobles, el carácter de comillas usado para incluir el valor se debe duplicar cada vez que se produce dentro del valor.
Para incluir espacios anteriores o finales en el valor de cadena, el valor debe ir entre comillas simples o comillas dobles. Se omiten los espacios iniciales o finales alrededor de valores enteros, booleanos o enumerados, incluso si se incluyen entre comillas. Sin embargo, se conservan los espacios dentro de una palabra clave o valor literal de cadena. Las comillas simples o dobles se pueden usar dentro de un cadena de conexión sin usar delimitadores (por ejemplo, Origen de datos= my'Server o Origen de datos= my"Server), a menos que un carácter de comillas sea el primer o último carácter del valor.
Las palabras clave no distinguen mayúsculas de minúsculas.
En la tabla siguiente se enumeran los nombres válidos para los valores de palabra clave dentro de ConnectionString.
Palabra clave | Default | Descripción |
---|---|---|
Addr | N/D | Sinónimo del origen de datos. |
Dirección | N/D | Sinónimo del origen de datos. |
Aplicación | N/D | Sinónimo del nombre de la aplicación. |
Nombre de la aplicación | N/D | Nombre de la aplicación o "Proveedor de datos SQLClient de .NET" si no se proporciona ningún nombre de aplicación. Un nombre de aplicación puede tener 128 caracteres o menos. |
ApplicationIntent |
ReadWrite |
Declara el tipo de carga de trabajo de la aplicación al conectarse a un servidor. Los valores posibles son ReadOnly y ReadWrite . Por ejemplo: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. |
Procesamiento asincrónico o bien Async |
'false' | Cuando true , habilita la compatibilidad con operaciones asincrónicas. Los valores reconocidos son true , false , yes y no .Esta propiedad se omite a partir de .NET Framework 4.5. Para obtener más información sobre la compatibilidad con SqlClient para la programación asincrónica, vea Programación asincrónica. |
AttachDBFilename o bien Propiedades extendidas o bien Nombre de archivo inicial |
N/D | Nombre del archivo de base de datos principal, incluido el nombre de ruta de acceso completa de una base de datos adjuntable. AttachDBFilename solo es compatible con archivos de datos primarios con una extensión .mdf. Si el valor de la clave AttachDBFileName se especifica en el cadena de conexión, la base de datos se adjunta y se convierte en la base de datos predeterminada para la conexión. Si no se especifica esta clave y si la base de datos se adjuntó anteriormente, la base de datos no se volverá a adjuntar. La base de datos adjunta anteriormente se usará como base de datos predeterminada para la conexión. Si esta clave se especifica junto con la clave AttachDBFileName, el valor de esta clave se usará como alias. Sin embargo, si el nombre ya se usa en otra base de datos adjunta, se producirá un error en la conexión. La ruta de acceso puede ser absoluta o relativa mediante la cadena de sustitución DataDirectory. Si se usa DataDirectory, el archivo de base de datos debe existir dentro de un subdirectorio del directorio al que apunta la cadena de sustitución. Nota: No se admiten los nombres de ruta de acceso de servidor remoto, HTTP y UNC. 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: "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. En este caso, se debe quitar el archivo de registro. 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. |
Authentication | N/D | El método de autenticación que se usa para conectarse a SQL Database mediante la autenticación de Azure Active Directory. Los valores válidos son: Active Directory Integrado, Contraseña de Active Directory, Contraseña de Sql. |
Configuración de cifrado de columnas | N/D | Habilita o deshabilita Always Encrypted funcionalidad para la conexión. |
Tiempo de espera de la conexión o bien Tiempo de espera de la conexión o bien Tiempo de espera |
15 | El período de tiempo (en segundos) que se esperará a una conexión al servidor antes de finalizar el intento y generar un error. Los valores válidos son mayores o iguales que 0 y menor o igual que 2147483647. Al abrir una conexión a una base de datos de Azure SQL, establezca el tiempo de espera de conexión en 30 segundos. |
Duración de la conexión o bien Tiempo de espera de equilibrio de carga |
0 | 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. 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.Un valor de cero (0) hace que las conexiones agrupadas tengan el tiempo de espera máximo de conexión. |
ConnectRetryCount | 1 | Controla el número de intentos de reconexión después de que el cliente identifique un error de conexión inactiva. Los valores válidos son de 0 a 255. El valor predeterminado es 1. 0 significa que no intente volver a conectarse (deshabilite la resistencia de la conexión). Para más información sobre la resistencia de la conexión, consulte Parámetros de SqlConnection de .NET para el reintento de conexión y el artículo técnico sobre resistencia de conexión inactiva. |
ConnectRetryInterval | 10 | Especifica el tiempo entre cada reintento de conexión (ConnectRetryCount). Los valores válidos son de 1 a 60 segundos (valor predeterminado=10), aplicados después del primer intento de reconexión. 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. Si se produce un error en el primer intento de reconexión y ConnectRetryCount es mayor que 1, el cliente espera a ConnectRetryInterval para probar el segundo y los intentos de reconexión posteriores. Para más información sobre la resistencia de la conexión, consulte Parámetros de SqlConnection de .NET para el reintento de conexión y el artículo técnico sobre resistencia de conexión inactiva. |
Conexión de contexto | 'false' |
true si se debe realizar una conexión en proceso a SQL Server. |
Idioma actual o bien Idioma |
N/D | Establece el idioma utilizado para los mensajes de error o advertencia del servidor de bases de datos. El nombre del idioma puede tener 128 caracteres o menos. |
Origen de datos o bien Servidor o bien Dirección o bien Addr o bien Dirección de red |
N/D | Nombre o dirección de red de la instancia de SQL Server a la que se va a conectar. El número de puerto se puede especificar después del nombre del servidor:server=tcp:servername, portnumber Al especificar una instancia local, use siempre (local). Para forzar un protocolo, agregue uno de los siguientes prefijos: np:(local), tcp:(local), lpc:(local) A partir de .NET Framework 4.5, también puede conectarse a una base de datos localDB de la siguiente manera: server=(localdb)\\myInstance Para obtener más información sobre LocalDB, consulte Compatibilidad con SqlClient para LocalDB. El origen de datos debe usar el formato TCP o el formato Canalizaciones con nombre. El formato TCP es el siguiente: - tcp:<host name>\<instance name> - 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 especifica un nombre de host y un nombre de instancia. Este formato no es aplicable al conectarse a Azure SQL Database. TCP se selecciona automáticamente para las conexiones a Azure SQL Base de datos cuando no se especifica ningún protocolo. El nombre de host DEBE especificarse de una de las maneras siguientes: - NetBIOSName - IPv4Address - IPv6Address El nombre de instancia se usa para resolver en un número de puerto TCP/IP determinado en el que se hospeda una instancia de base de datos. Como alternativa, también se permite especificar un número de puerto TCP/IP directamente. Si el nombre de instancia y el número de puerto no están presentes, se usa la instancia de base de datos predeterminada. El formato Canalizaciones con nombre es el siguiente: - np:\\<host name>\pipe\<pipe name> El formato Canalizaciones con nombre DEBE comenzar con el prefijo "np:" y va seguido de un nombre de canalización con nombre. El nombre de host DEBE especificarse de una de las maneras siguientes: - NetBIOSName - IPv4Address - IPv6Address El nombre de canalización se usa para identificar la instancia de base de datos a la que se conectará la aplicación de .NET Framework. Si se especifica el valor de la clave de red , no se deben especificar los prefijos "tcp:" y "np:". Nota: Puede forzar el uso de TCP en lugar de memoria compartida, ya sea mediante el prefijo tcp: al nombre del servidor en el cadena de conexión o mediante localhost. |
Cifrado | 'false' | Cuando true , SQL Server usa el cifrado SSL para todos los datos enviados entre el cliente y el servidor si el servidor tiene instalado un certificado. Los valores reconocidos son true , false , yes y no . Para obtener más información, vea Sintaxis de cadena de conexión.A partir de .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 dirección IP) especificado en el cadena de conexión. De lo contrario, se producirá un error en el intento de conexión. |
Dar de alta | 'true' |
true indica que el SQL Server agrupador de conexiones da de alta automáticamente la conexión en el contexto de transacción actual del subproceso de creación. |
Failover Partner | N/D | Nombre del servidor asociado de conmutación por error donde se configura la creación de reflejo de la base de datos. Si el valor de esta clave es "", el catálogo inicial debe estar presente y su valor no debe ser "". El nombre del servidor puede tener 128 caracteres o menos. 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 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. 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. |
Catálogo original o bien Base de datos |
N/D | El nombre de la base de datos. El nombre de la base de datos puede tener 128 caracteres o menos. |
Seguridad integrada o bien Trusted_Connection |
'false' | Cuando false , el identificador de usuario y la contraseña se especifican en la conexión. Cuando true , las credenciales actuales de la cuenta de Windows se usan para la autenticación.Los valores reconocidos son true , false , yes , no y sspi (muy recomendable), que equivale a true .Si se especifican el identificador de usuario y la contraseña y la seguridad integrada se establece en true, se omitirá el identificador de usuario y la contraseña y se usará la seguridad integrada. SqlCredentiales una manera más segura de especificar las credenciales de una conexión que usa SQL Server Autenticación ( Integrated Security=false ). |
Max Pool Size | 100 | Número máximo de conexiones permitidas en el grupo. Los valores válidos son mayores o iguales que 1. Los valores que son menores que el tamaño mínimo del grupo generan un error. |
Min Pool Size | 0 | Número mínimo de conexiones permitidas en el grupo. Los valores válidos son mayores o iguales que 0. Cero (0) en este campo significa que no se abren inicialmente conexiones mínimas. Los valores mayores que el tamaño máximo del grupo generan un error. |
MultipleActiveResultSets | 'false' | Cuando true es , una aplicación puede mantener varios conjuntos de resultados activos (MARS). Cuando false , una aplicación debe procesar o cancelar todos los conjuntos de resultados de un lote para poder ejecutar cualquier otro lote en esa conexión.Los valores reconocidos son true y false .Para obtener más información, consulte Conjuntos de resultados activos múltiples (MARS). |
MultiSubnetFailover |
false | Especifique multiSubnetFailover=True siempre al conectarse al agente de escucha del grupo de disponibilidad de un grupo de disponibilidad SQL Server 2012 (o posterior) o a una instancia de clúster de conmutación por error de SQL Server 2012 (o posterior).
multiSubnetFailover=True configura SqlClient para proporcionar una detección y conexión más rápidas al servidor activo (actualmente). Los valores posibles son Yes y No , True y False o 1 y 0 . Por ejemplo:MultiSubnetFailover=True De manera predeterminada, es False . Para obtener más información sobre la compatibilidad de SqlClient con Always On grupos de disponibilidad, consulte Compatibilidad de SqlClient con alta disponibilidad y recuperación ante desastres. |
Biblioteca de red o bien Red o bien Net |
N/D | Biblioteca de red que se usa para establecer una conexión a una instancia de SQL Server. Los valores admitidos son: dbnmpntw (canalizaciones con nombre) dbmsrpcn (Multiprotocol, Windows RPC) dbmsadsn (Apple Talk) dbmsgnet (VIA) dbmslpcn (memoria compartida) dbmsspxn (IPX/SPX) dbmssocn (TCP/IP) Dbmsvinn (Banyan Vines) El DLL de red correspondiente debe estar instalado en el sistema al que se conecte. Si no especifica una red y usa un servidor local (por ejemplo, "." o "(local)"), se usa la memoria compartida. En este ejemplo, la biblioteca de red es Win32 Winsock TCP/IP (dbmssocn), y 1433 es el puerto que se está utilizando. Network Library=dbmssocn;Data Source=000.000.000.000,1433; |
Tamaño del paquete | 8000 | Tamaño en bytes de los paquetes de red usados para comunicarse con una instancia de SQL Server. El tamaño del paquete puede ser mayor o igual que 512 y menor o igual que 32768. |
Contraseña o bien PWD |
N/D | Contraseña del inicio de sesión de la cuenta de SQL Server. No se recomienda. Para mantener un alto nivel de seguridad, se recomienda encarecidamente usar la Integrated Security palabra clave o Trusted_Connection en su lugar.
SqlCredentiales una manera más segura de especificar credenciales para una conexión que usa SQL Server autenticación.La contraseña debe tener 128 caracteres o menos. |
Persist Security Info o bien PersistSecurityInfo |
'false' | Cuando se establece false en 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 ha estado en un estado abierto. Al restablecer el cadena de conexión se restablecen todos los valores de cadena de conexión, incluida la contraseña. Los valores reconocidos son true , false , yes y no . |
PoolBlockingPeriod | Auto | Establece el comportamiento del período de bloqueo para un grupo de conexiones. Consulte la propiedad PoolBlockingPeriod para obtener detalles. |
Agrupación | '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 lo cierre. En un siguiente intento de abrir la misma conexión, esa conexión se extraerá del grupo. Connections se consideran iguales si tienen la misma cadena de conexión. Las distintas conexiones tienen cadenas de conexión diferentes. El valor de esta clave puede ser "true", "false", "sí" o "no". |
Replicación | 'false' |
true si se admite la replicación mediante la conexión. |
Enlace por transacciones | Desenlace implícito | Controla la asociación de conexión con una transacción en la que se ha System.Transactions inscrito.Los valores posibles son: Transaction Binding=Implicit Unbind; Transaction Binding=Explicit Unbind; Unbind implícito hace que la conexión se desasocie de la transacción cuando finaliza. Después de la separación, las solicitudes adicionales en la conexión son ejecutadas en modo de confirmación automática. La propiedad System.Transactions.Transaction.Current no es comprobada al ejecutar solicitudes mientras la trasacción esté activa. 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.Si el sistema finaliza la transacción (en el ámbito de un bloque using) antes de que se complete el último comando, se producirá InvalidOperationException. Unbind explícito hace que la conexión permanezca adjunta a la transacción hasta que se cierre la conexión o se llame a un explícito SqlConnection.TransactionEnlist(null) . A partir de .NET Framework 4, los cambios en Desenlace implícito hacen que la desenlace explícita está obsoleta. 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. |
TransparentNetworkIPResolution | Consulte la descripción. | 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. Si la conexión no se establece en 0,5 segundos, la aplicación intentará conectarse a todas las demás en paralelo. Cuando la primera responda, la aplicación establecerá la conexión con la dirección IP encuestada.Si la MultiSubnetFailover clave se establece true en , TransparentNetworkIPResolution se omite.Si se establece la Failover Partner clave, TransparentNetworkIPResolution se omite.El valor de esta clave debe ser true , false , yes o no .Un valor de yes se trata igual que un valor de true .Un valor de no se trata igual que un valor de false .Los valores predeterminados son los siguientes:
|
TrustServerCertificate | 'false' | Cuando se establece en true , se usa SSL para cifrar el canal al pasar la cadena de certificados para validar la confianza. Si TrustServerCertificate está establecido true en y Encrypt está establecido false en , el canal no se cifra. Los valores reconocidos son true , false , yes y no . Para obtener más información, vea Sintaxis de cadena de conexión. |
Versión del sistema de tipos | N/D | Valor de cadena que indica el sistema de tipos que espera la aplicación. 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. 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.
Nota: La versión del sistema de tipo no se puede establecer para el código de Common Language Runtime (CLR) que se ejecuta en proceso en SQL Server. Para obtener más información, consulte SQL Server Integración de Common Language Runtime. Los valores posibles son: 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. La otra Type System Version configuración requerirá la versión 10.0.0.0 de Microsoft.SqlServer.Types.dll.Latest está obsoleto y no debe usarse.
Latest equivale a Type System Version=SQL Server 2008; . |
Id. de usuario o bien UID o bien Usuario |
N/D | Cuenta de inicio de sesión de SQL Server. No se recomienda. Para mantener un alto nivel de seguridad, se recomienda encarecidamente usar las palabras Integrated Security clave o Trusted_Connection en su lugar.
SqlCredentiales una manera más segura de especificar credenciales para una conexión que usa SQL Server autenticación.El identificador de usuario debe tener 128 caracteres o menos. |
Instancia de usuario | 'false' | Valor que indica si se va a redirigir la conexión desde la instancia de SQL Server Express predeterminada a una instancia iniciada por el entorno de ejecución que se ejecuta en la cuenta del autor de la llamada. |
Id. de estación de trabajo o bien WSID |
Nombre del equipo local | Nombre de la estación de trabajo que se conecta a SQL Server. El identificador debe tener 128 caracteres o menos. |
La lista siguiente contiene los nombres válidos para los valores de agrupación de conexiones dentro de ConnectionString. Para obtener más información, vea Agrupación de conexiones de SQL Server (ADO.NET).
Duración de la conexión (o tiempo de espera del equilibrio de carga)
Dar de alta
Max Pool Size
Min Pool Size
Agrupación
Cuando se establecen valores de agrupación de palabra clave o conexión que requieren un valor booleano, puede usar "sí" en lugar de "true" y "no" en lugar de "false". Los valores enteros se representan como cadenas.
Nota
El proveedor de datos de .NET Framework para SQL Server usa su propio protocolo para comunicarse con 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.
Nota
Los archivos de vínculo de datos universales (UDL) no se admiten para el proveedor de datos de .NET Framework para SQL Server.
Precaución
En esta versión, la aplicación debe tener precaución al construir un cadena de conexión en función de la entrada del usuario (por ejemplo, al recuperar el identificador de usuario y la información de contraseña de un cuadro de diálogo y anexarlo al cadena de conexión). 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, escribir una contraseña como "validpassword; database=somedb" en un intento de adjuntar a otra base de datos). Si necesita construir cadenas de conexión basadas en la entrada del usuario, use el nuevo SqlConnectionStringBuilder, que valida el cadena de conexión y ayuda a eliminar este problema. Consulte Generadores de cadenas de conexión para obtener más información.