Propiedad ConnectionString (ADO)
Obtiene o establece la información que se usa para establecer una conexión con un origen de datos.
Configuración y valores devueltos
Establece o devuelve un valor de cadena.
Comentarios
Utilice la propiedad ConnectionString para especificar un origen de datos pasando un cadena de conexión detallado que contiene una serie de instrucciones argument = value separadas por punto y coma.
ADO admite cinco argumentos para la propiedad ConnectionString; cualquier otro argumento pasa directamente al proveedor sin ser procesado por ADO. Los argumentos que admite ADO son los siguientes:
| Argumento | Descripción |
|---|---|
| Provider= | Especifica el nombre de un proveedor que se usará para la conexión. |
| File Name= | Especifica el nombre de un archivo específico del proveedor (por ejemplo, un objeto de origen de datos persistente) que contiene información de conexión preestablecida. |
| Remote Provider= | Especifica el nombre de un proveedor que se va a usar al abrir una conexión del lado cliente (Solo servicio de datos remotos). |
| Remote Server= | Especifica el nombre de la ruta de acceso del servidor que se usará al abrir una conexión del lado cliente. (Solo servicio de datos remotos). |
| URL= | Especifica la cadena de conexión como una dirección URL absoluta que identifica un recurso, como un archivo o directorio. |
Después de establecer la propiedad ConnectionString y abrir el objeto Connection, el proveedor puede modificar el contenido de la propiedad, por ejemplo, asignando los nombres de los argumento definidos por ADO a sus equivalentes para el proveedor específico.
La propiedad ConnectionString hereda automáticamente el valor utilizado para el argumento ConnectionString del método Open, por lo que puede invalidar la propiedad actual ConnectionString durante la llamada de método a Open.
Dado que el argumento Nombre de archivo hace que ADO cargue el proveedor asociado, no se pueden pasar los argumentos Proveedor y Nombre de archivo.
La propiedad ConnectionString es de lectura y escritura cuando la conexión está cerrada y es de solo lectura cuando está abierta.
Se omiten los duplicados de un argumento en la propiedad ConnectionString. Se usa la última instancia de cualquier argumento.
Nota:
Uso del servicio de datos remotos Cuando se usa en un objeto Connection del lado cliente, la propiedad ConnectionString solo puede incluir los parámetros Proveedor remoto y Servidor remoto.
La siguiente tabla muestra el proveedor de ADO predeterminado para cada sistema operativo Windows:
| Proveedor de ADO predeterminado | Sistema operativo Windows |
|---|---|
| MSDASQL (Para mejorar la legibilidad del código fuente, especifique explícitamente el nombre del proveedor en la cadena de conexión). |
Windows 2000 (32 bits) Windows XP (32 bits) Windows Server 2003 (32 bits) Windows Vista (32 bits) Windows Vista Service Pack 1 o posterior (32 y 64 bits) Versiones de Windows después de Windows Vista (32 y 64 bits) |
| No hay valor predeterminado. Cuando una aplicación de ADO se ejecuta en los siguientes sistemas operativos y no especifica explícitamente el proveedor, ADO devuelve el siguiente error: "ADODB.Connection: el proveedor no se ha especificado y no hay ningún proveedor predeterminado designado" |
Windows 2000 (64 bits) Windows XP (64 bits) Windows Server 2003 (64 bits) Windows Vista (64 bits) |
Se aplica a
Consulte también
Ejemplo de propiedades ConnectionString, ConnectionTimeout y State (VB)
Ejemplo de propiedades ConnectionString, ConnectionTimeout y State (VC++)
Apéndice A: Proveedores