Метод QueryTable.Refresh (Excel)

Обновления диапазон внешних данных в объекте QueryTable.

Синтаксис

expression. Обновление (BackgroundQuery)

Выражение Переменная, представляющая объект QueryTable .

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
BackgroundQuery	Необязательный	Variant	Используется только с queryTable, основанными на результатах SQL-запроса. Значение true , чтобы вернуть управление процедурой сразу после подключения к базе данных и отправки запроса. QueryTable обновляется в фоновом режиме. Значение false , чтобы вернуть управление процедуре только после получения всех данных на лист. Если этот аргумент не указан, параметр свойства BackgroundQuery определяет режим запроса.

Возвращаемое значение

Boolean

Примечания

Следующие примечания относятся к объектам 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.

Если запрос требует параметров, перед вызовом метода Refresh коллекция Parameters должна быть инициализирована с помощью сведений о привязке параметров. Если не достаточно параметров было привязано, метод Refresh завершается ошибкой с исключением ошибка параметра. Если для параметров задан запрос их значений, для пользователя отображаются диалоговые окна независимо от значения свойства DisplayAlerts . Если пользователь отменяет диалоговое окно параметров, метод Refresh останавливается и возвращает значение False. Если дополнительные параметры связаны с коллекцией Parameters , эти дополнительные параметры игнорируются.

Метод Refresh возвращает значение True , если запрос успешно завершен или запущен; Возвращает значение False , если пользователь отменяет подключение или диалоговое окно параметров.

Чтобы узнать, превышает ли количество извлекаемых строк количество доступных строк на листе, изучите свойство FetchedRowOverflow . Это свойство инициализируется при каждом вызове метода Refresh .

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.