SqlConnection.ConnectionString Propiedad

Definición

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); };
[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }
public override string ConnectionString { get; set; }
[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with 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. El valor predeterminado es una cadena vacía.

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.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        OpenSqlConnection();
        Console.ReadLine();
    }

    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;";
    }
}

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 trueen .
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.
Intención de aplicaciones

O bien

Intención de aplicaciones
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.
Nombre de la aplicación N/D Nombre de la aplicación. Si no se proporciona ningún nombre de aplicación, "Proveedor de datos SqlClient de Microsoft Framework" al ejecutarse en .NET Framework y "Core Microsoft SqlClient Data Provider" de lo contrario.

Un nombre de aplicación puede tener 128 caracteres o menos.
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.
Protocolo de atestación NotSpecified Obtiene o establece el valor de Protocolo de atestación.

Cuando no se especifica ningún valor, los enclaves seguros se deshabilitan en la conexión.

Los valores válidos son:
AAS
HGS
None (Solo es válido en v3.1 y v4.1+))
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 Integrated, Active Directory Interactive, Active Directory Password, Active Directory Service Principal, Active Directory Device Code Flow, Active Directory Managed Identity, Active Directory MSI, Active Directory Default, Sql Password.

Para más información, consulte Uso de la autenticación de Azure Active Directory con SqlClient.
Configuración de cifrado de columnas deshabilitado Habilita o deshabilita Always Encrypted funcionalidad para la conexión. Los valores admitidos son: enabled y disabled
Tiempo de espera del comando 30 Tiempo de espera predeterminado (en segundos) antes de terminar el intento de ejecutar un comando y generar un error.

Los valores válidos son mayores o iguales que 0 y menor o igual que 2147483647.
Recuento de reintentos de conexión

O bien

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. 0 significa que no intente volver a conectarse (deshabilite la resistencia de la conexión).

Nota: Desde la versión 5.x, el valor predeterminado para los puntos de conexión que no son de Azure es 1. Para Azure SQL puntos de conexión, el valor predeterminado es 2. Para Azure SQL puntos de conexión sin servidor o a petición, el valor predeterminado es 5 para mejorar el éxito de la conexión para las conexiones a una instancia inactiva o en pausa.

Para más información sobre la resistencia de conexión inactiva, consulte Parámetros de SqlConnection de .NET para el reintento de conexión y el artículo técnico: resistencia de conexión inactiva.
Intervalo de reintentos de conexión

O bien

ConnectRetryInterval
10 Especifica el tiempo entre cada reintento de conexión (ConnectRetryCount). Los valores válidos son de 1 a 60 segundos (default=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 probar el segundo y los intentos ConnectRetryInterval de reconexión posteriores.

Para más información sobre la resistencia de la conexión inactiva, consulte Parámetros de SqlConnection de .NET para el reintento de conexión y el artículo técnico: resistencia de conexión inactiva.
Tiempo de espera de la conexión

o bien

Tiempo de espera de la conexión

o bien

Tiempo de espera
15 El 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.
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)

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 Database 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 directamente un número de puerto TCP/IP. 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 la canalización se usa para identificar la instancia de base de datos a la que se conectará la aplicación .NET.

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.
Dirección URL de atestación de enclave N/D Obtiene o establece la dirección URL de atestación del enclave que se va a usar con la Always Encrypted basada en enclaves.
Cifrado 'true' en la versión 4.0 y posteriores

'false' en la versión 3.x y inferior
Los valores reconocidos son:
versiones 1 - 4: true/yes y false/no
versiones 5 y posteriores: true/yesmandatory/y . false/no/optionalstrict Cuando true, se usa el cifrado TLS para todos los datos enviados entre el cliente y el servidor si el servidor tiene instalado un certificado. Cuando strict, se usa el cifrado TLS de TDS 8.0 y la TrustServerCertificate configuración se omite y se trata como false. Para obtener más información, vea Sintaxis de cadena de conexión.

Cuando Encrypt es o strict y TrustServerCertificate es falsemandatory , el nombre del servidor (o la dirección IP) del certificado de un servidor 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' trueindica que el agrupador de conexiones de SQL Server inscribe 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 (especificado con la palabra clave Server) se realizará correctamente si el servidor principal está disponible.
SPN de asociado de conmutación por error

O bien

FailoverPartnerSPN
N/D SPN del asociado de conmutación por error. El valor predeterminado es una cadena vacía, lo que hace que SqlClient use el SPN generado por el controlador predeterminado.

(Solo disponible en v5.0+)
Nombre de host en certificado

O bien

HostNameInCertificate
N/D Nombre de host que se va a usar al validar el certificado de servidor. Cuando no se especifica, el nombre del servidor del origen de datos se usa para la validación de certificados.

(Solo disponible en v5.0+)
Certificado de servidor

O bien

ServerCertificate
N/D Ruta de acceso a un archivo de certificado que debe coincidir con el certificado TLS/SSL de SQL Server. Los formatos de certificado permitidos son PEM, DER y CER. Si se especifica, el certificado de SQL Server se comprueba comprobando si ServerCertificate proporcionado es una coincidencia exacta.

(Solo disponible en v5.1 y versiones posteriores)
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 truees , las credenciales actuales de la cuenta de Windows se usan para la autenticación.

Los valores reconocidos son true, yesfalse, , noy sspi (se recomienda encarecidamente), que es equivalente 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á seguridad integrada.

SqlCredentiales una manera más segura de especificar credenciales para una conexión que usa la autenticación de SQL Server (Integrated Security=false).
Preferencia de dirección IP

O bien

IPAddressPreference
IPv4First Preferencia de familia de direcciones IP al establecer conexiones TCP. Si Transparent Network IP Resolution (en .NET Framework) o Multi Subnet Failover se establece en true, esta configuración no tiene ningún efecto. Los valores admitidos son:

IPAddressPreference=IPv4First

IPAddressPreference=IPv6First

IPAddressPreference=UsePlatformDefault
Tiempo de espera de equilibrio de carga

O bien

Duración de la conexión
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.
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 que son mayores que el tamaño máximo del grupo generan un error.
Conjunto de resultados activo múltiple (MARS)

O bien

MultipleActiveResultSets
false Cuando truees , una aplicación puede mantener varios conjuntos de resultados activos (MARS). Cuando falsees , 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.

Los valores reconocidos son true y false.

Para obtener más información, consulte Conjuntos de resultados activos múltiples (MARS).
Conmutación por error de varias subredes

O bien

MultiSubnetFailover
false multiSubnetFailover=True Especifique siempre al conectarse al agente de escucha del grupo de disponibilidad de un grupo de disponibilidad de 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 más rápida de y la conexión con el 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 con SqlClient para alta disponibilidad y recuperación ante desastres.
Biblioteca de red

o bien

Red

o bien

Net
N/D La biblioteca de red utilizada 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 La 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 la autenticación SQL Server.

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 o el token de acceso, no se devuelve como parte de la conexión si la conexión está abierta o ha estado en un estado abierto. Esta propiedad solo debe establecerse true en si la aplicación tiene una necesidad específica de leer la contraseña de una conexión de base de datos ya abierta. El valor predeterminado de false es la configuración más segura; el uso true de para esta propiedad abre la aplicación a riesgos de seguridad, como el registro accidental o el seguimiento de la contraseña de la base de datos.

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.
Período de bloqueo del grupo

O bien

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.
Dirección SPN del servidor

O bien

ServerSPN
N/D SpN para el origen de datos. El valor predeterminado es una cadena vacía, lo que hace que SqlClient use el SPN generado por el controlador predeterminado.

(Solo disponible en v5.0+)
Enlace por transacciones Desenlace implícito Controla la asociación de conexión con una transacción enlistada System.Transactions .

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 conectada 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.0, los cambios en El enlace 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.
Resolución de IP de red transparente

O bien

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 trueen , TransparentNetworkIPResolution se omite.

Si se establece la Failover Partner clave, TransparentNetworkIPResolution se omite.

El valor de esta clave debe ser true, false, yeso 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:

  • false Cuando:

    • Conexión a Azure SQL base de datos donde finaliza el origen de datos:

      • .database.chinacloudapi.cn
      • .database.usgovcloudapi.net
      • .database.cloudapi.de
      • .database.windows.net
    • Authentication es "Contraseña de Active Directory" o "Active Directory Integrado".
  • true en todos los demás casos.
TrustServerCertificate

O bien

TrustServerCertificate
'false' Cuando se establece en true, se usa TLS para cifrar el canal al pasar la cadena de certificados para validar la confianza. Si TrustServerCertificate está establecido en y Encrypt está establecido truefalseen , 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 tipos 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.

Se aplica a