_QueryTable.Refresh(Object) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Обновления диапазон внешних данных (QueryTable). Логическое значение.
public bool Refresh (object BackgroundQuery);Public Function Refresh (Optional BackgroundQuery As Object) As BooleanПараметры
- BackgroundQuery
- Object
Необязательный объект. Используется только с queryTable, основанными на результатах SQL-запроса. Значение true , чтобы вернуть управление процедурой сразу после подключения к базе данных и отправки запроса. QueryTable обновляется в фоновом режиме. Значение false , чтобы вернуть управление процедуре только после получения всех данных на лист. Если этот аргумент не указан, параметр BackgroundQuery свойства определяет режим запроса.
Возвращаемое значение
Комментарии
Следующие примечания относятся к объектам QueryTable , основанным на результатах SQL-запроса.
Метод Refresh заставляет Microsoft Excel подключаться к источнику данных объекта QueryTable , выполнять SQL-запрос и возвращать данные в диапазон, основанный на объекте QueryTable . Если этот метод не вызывается, объект QueryTable не взаимодействует с источником данных.
При подключении к источнику данных OLE DB или ODBC Microsoft Excel использует строка подключения, заданный свойством Connection . Если в указанном строка подключения отсутствуют необходимые значения, будут отображаться диалоговые окна с запросом у пользователя ввести необходимые сведения. DisplayAlerts Если свойство имеет значение False, диалоговые окна не отображаются, а метод Refresh завершается ошибкой с исключением недостаточных сведений о подключении.
После успешного подключения Microsoft Excel сохраняет завершенные строка подключения, чтобы не отображались запросы для последующих вызовов метода Refresh во время того же сеанса редактирования. Полный строка подключения можно получить, изучив значение Connection свойства .
После подключения к базе данных выполняется проверка SQL-запроса. Если запрос недопустим, метод Refresh завершается ошибкой с исключением ошибки синтаксиса SQL.
Если запрос требует параметров, перед вызовом Parameters метода Refresh коллекция должна быть инициализирована с помощью сведений о привязке параметров. Если не достаточно параметров было привязано, метод Refresh завершается ошибкой с исключением ошибка параметра. Если для параметров задан запрос их значений, для пользователя отображаются диалоговые окна независимо от того, какой параметр свойства задан DisplayAlerts . Если пользователь отменяет диалоговое окно параметров, метод Refresh останавливается и возвращает значение False. Если дополнительные параметры связаны с коллекцией Parameters , эти дополнительные параметры игнорируются.
Метод Refresh возвращает значение True , если запрос успешно завершен или запущен; Возвращает значение False , если пользователь отменяет подключение или диалоговое окно параметров.
Чтобы узнать, превышает ли количество извлекаемых строк количество доступных строк на листе, изучите FetchedRowOverflow свойство . Это свойство инициализируется при каждом вызове метода Refresh .