QueryTable.Refresh method (Excel)

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

Синтаксис

выражение. Обновить (BackgroundQuery)

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

Параметры

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

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

Boolean

Примечания

Следующие замечания относятся к объектам QueryTable , основанным на результатах SQL-запроса.

Метод Refresh заставляет Microsoft Excel подключиться к источнику данных объекта QueryTable, выполнить SQL-запрос и вернуть данные в диапазон, основанный на объекте QueryTable. Если этот метод не вызван, объект QueryTable не взаимодействует с источником данных.

При подключении к источнику данных OLE DB или ODBC Microsoft Excel использует строку подключения, указанную в свойстве "Подключение". Если в указанной строке подключения отсутствуют обязательные значения, отобразятся диалоговые окна, предлагающие пользователю ввести требуемую информацию. Если свойство DisplayAlerts имеет значение False, диалоговые окна не отображаются, а метод обновления завершается сбоем с исключением "Недостаточно сведений о подключении".

После успешного подключения Microsoft Excel сохраняет завершенную строку подключения, поэтому запросы не будут отображаться для последующих вызовов метода Refresh во время одного и того же сеанса редактирования. Вы можете получить готовую строку подключения, проверив значение свойства Connection.

После подключения к базе данных выполняется проверка SQL-запроса. Если запрос недопустим, метод Refresh завершается ошибкой с исключением синтаксической ошибки SQL.

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

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

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

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

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