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); };
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 un SqlConnection objeto y 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 una cadena de conexión OLE DB, pero no es idéntica. A diferencia de OLE DB o ADO, la cadena de conexión que se devuelve es la misma que la establecida 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 una cadena de conexión a menos que establezca Conservar información truede seguridad en .

Puede usar la ConnectionString propiedad para conectarse a una base de datos. En el ejemplo siguiente se muestra una cadena de conexión típica.

"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 la 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 opciones de configuración 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 una cadena de conexión que incluye "Database= AdventureWorks" y, a continuación, restablece la cadena de conexión a "Data Source=myserver;Integrated Security=true", la Database propiedad ya no se establece en "AdventureWorks".

La 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 una cadena de conexión incluye una serie de pares 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 comilla simple 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 comilla doble, 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 comilla simple y de comillas dobles, el carácter de comillas usado para incluir el valor se debe duplicar cada vez que se produzca 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 los 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 una cadena de conexión sin usar delimitadores (por ejemplo, Data Source= my'Server o Data Source= 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 Valor predeterminado 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 de Nombre de 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, consulte 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 la 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 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 en el siguiente:

"AttachDbFileName=&#124;DataDirectory&#124;\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 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 de conexión máximo.
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 obtener 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: 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 (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 ConnectRetryInterval para probar el segundo y los intentos de reconexión posteriores.

Para obtener 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: Resistencia de conexión inactiva.
Conexión de contexto 'false' truesi 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 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 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 la 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 de SQL Server debe coincidir exactamente con el nombre del servidor (o dirección IP) especificado en la 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.
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).
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.
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).
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, no se devuelve como parte de la conexión si la conexión está abierta o ha estado en un estado abierto. Al restablecer la 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.

Las conexiones 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 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, los cambios en Unbind 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 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 'false' Cuando se establece en true, se usa SSL para cifrar el canal al pasar por 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 La cuenta de inicio de sesión SQL Server. No se recomienda. Para mantener un alto nivel de seguridad, se recomienda encarecidamente usar las Integrated Security palabras 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.

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 en tiempo de ejecución que se ejecuta en la cuenta del autor de la llamada.
Id. de estación de trabajo

o bien

WSID
El 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 de equilibrio de carga)

  • Dar de alta

  • Max Pool Size

  • Min Pool Size

  • Agrupación

Cuando se establecen valores de agrupación de palabras 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 universal (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 una cadena de conexión basada en 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 anexarla a la 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 una base de datos diferente). Si necesita construir cadenas de conexión basadas en la entrada del usuario, use el nuevo SqlConnectionStringBuilder, que valida la 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

Consulte también