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

Use la propiedad ConnectionString para especificar un origen de datos pasando una cadena de conexión detallada que contenga 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 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

Objeto de conexión (ADO)

Consulte también

Ejemplo de propiedades ConnectionString, ConnectionTimeout y State (VB)
Ejemplo de propiedades ConnectionString, ConnectionTimeout y State (VC++)
Apéndice A: Proveedores