Share via

_QueryTable.Refresh(Object) Método

  • Referencia

Definición

Espacio de nombres:
Microsoft.Office.Interop.Excel
Ensamblado:
Microsoft.Office.Interop.Excel.dll

Novedades un intervalo de datos externo (QueryTable). Boolean.

public bool Refresh (object BackgroundQuery);
Public Function Refresh (Optional BackgroundQuery As Object) As Boolean

Parámetros

BackgroundQuery
Object

Objeto opcional. 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 BackgroundQuery propiedad determina el modo de consulta.

Devoluciones

Boolean

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 usa la cadena de conexión especificada por la Connection propiedad . 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 DisplayAlerts propiedad es False, no se muestran los cuadros de diálogo y se produce un error en el método Refresh con 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 el cadena de conexión completado examinando el valor de la Connection propiedad .

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 Parameters colección 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 establecen para solicitar sus valores, los cuadros de diálogo se muestran al usuario independientemente de la configuración de la DisplayAlerts propiedad. 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 capturadas superó el número de filas disponibles en la hoja de cálculo, examine la FetchedRowOverflow propiedad . Esta propiedad se inicia cada vez que se llama al método Refresh.

Se aplica a