Método QueryTable.Refresh (Excel)

Actualiza un intervalo de datos externos en un objeto QueryTable.

Sintaxis

expresión. Refresh (BackgroundQuery)

expresión Variable que representa un objeto QueryTable.

Parameters

Nombre Obligatorio/opcional Tipo de datos Descripción
BackgroundQuery Opcional Variant Solo se usa con la colección QueryTables basada en el resultado de una consulta SQL. Si es True, el control se devuelve al procedimiento en el momento en el que se establezca una conexión con la base de datos y se envíe la consulta. El objeto QueryTable se actualiza en segundo plano. Establezca su valor en False para que el control se devuelva al procedimiento solamente cuando todos los datos se hayan capturado para la hoja de cálculo.

Si no se especifica este argumento, el valor de la propiedad BackgroundQuery determina el modo de consulta.

Valor devuelto

Booleano

Comentarios

Los siguientes comentarios son aplicables a los objetos QueryTable basados en los resultados de una consulta SQL.

El método Refresh hace que Microsoft Excel se conecte al origen de datos del objeto QueryTable, ejecute la consulta SQL y devuelva los datos al intervalo basado en el objeto QueryTable. Hasta que no se llame a este método, el objeto QueryTable no se comunica con el origen de datos.

Al realizar la conexión al origen de datos OLE DB u ODBC, Microsoft Excel la cadena de conexión especificada por la propiedad Connection. Si la cadena de conexión especificada no tiene los valores necesarios, se muestran cuadros de diálogos para solicitar al usuario la información necesaria. Si la propiedad DisplayAlerts tiene el valor False, no se muestran cuadros de diálogo, el método Refresh no se completa y se produce la excepción Información de conexión insuficiente.

Cuando Microsoft Excel establece una conexión satisfactoria, almacena la cadena de conexión completa para que no se muestren más mensajes en las llamadas posteriores al método Refresh durante la misma sesión de edición. Puede obtener la cadena de conexión completa examinando el valor de la propiedad Connection.

Una vez efectuada la conexión con la base de datos, se valida la consulta SQL. Si la consulta no es válida, el método Refresh no se completa y se produce la excepción Error de sintaxis SQL.

Si la consulta requiere parámetros, la colección Parameters debe inicializarse con información de enlace de parámetros antes de llamar al método Refresh. Si no se encuentran suficientes parámetros, el método Refresh no se completa y produce la excepción Error de parámetro. Si los parámetros se definen de manera que soliciten sus valores, se muestran cuadros de diálogo independientemente del valor de la propiedad DisplayAlerts. Si el usuario cancela el cuadro de diálogo de un parámetro, el método Refresh se detiene y devuelve False. Si hay parámetros adicionales enlazados a la colección Parameters, se pasan por alto dichos parámetros.

El método Refresh devuelve True si la consulta se inicia o completa con éxito; devuelve False si el usuario cancela un cuadro de diálogo de conexión o de parámetro.

Para ver si el número de filas recuperadas superó el número de filas disponibles en la hoja de cálculo, examine la propiedad FetchedRowOverflow. Esta propiedad se inicia cada vez que se llama al método Refresh.

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.