QueryTable Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет таблицу листа, созданную на основе данных, возвращаемых из внешнего источника данных, например sql server или базы данных Microsoft Access. Объект QueryTable является членом QueryTables коллекции.
public interface class QueryTable : Microsoft::Office::Interop::Excel::_QueryTable, Microsoft::Office::Interop::Excel::RefreshEvents_Event
[System.Runtime.InteropServices.Guid("00024428-0000-0000-C000-000000000046")]
public interface QueryTable : Microsoft.Office.Interop.Excel._QueryTable, Microsoft.Office.Interop.Excel.RefreshEvents_Event
Public Interface QueryTable
Implements _QueryTable, RefreshEvents_Event
- Производный
- Атрибуты
- Реализации
Комментарии
Это интерфейс .NET, полученный из компонентного класса COM, который требуется управляемому программному коду для взаимодействия с соответствующим объектом COM. Используйте этот вторичный интерфейс для доступа ко всем методам, свойствам и членам событий объекта COM. Однако если метод или событие, которые требуется использовать, имеют одно и то же имя в каком-либо объекте COM, для вызова метода приведите к соответствующему основному интерфейсу, для соединения с событием приведите к интерфейсу последних событий. Для получения дополнительной информации об объекте COM обращайтесь к этому разделу. Сведения о методах и элементах свойств объекта COM см. в разделе _QueryTable.
Используйте QueryTables(index
), где index
— номер индекса таблицы запросов, чтобы вернуть один объект QueryTable .
Свойства
AdjustColumnWidth |
Значение true , если ширина столбцов автоматически настраивается для оптимального соответствия при каждом обновлении указанной таблицы запросов или XML-карты. Значение false , если ширина столбцов не настраивается автоматически при каждом обновлении. Значение по умолчанию — True. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
Application |
Application Возвращает объект , представляющий приложение Microsoft Excel. Только для чтения. (Унаследовано от _QueryTable) |
BackgroundQuery |
Значение true , если запросы для отчета сводной таблицы или таблицы запросов выполняются асинхронно (в фоновом режиме). Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
CommandText |
Возвращает или задает командную строку для указанного источника данных. Объект чтения и записи. (Унаследовано от _QueryTable) |
CommandType |
Возвращает или задает константу XlCmdType , описывающую тип команды, связанный со свойством CommandText . Значение по умолчанию — xlCmdSQL. Чтение и запись XlCmdType. (Унаследовано от _QueryTable) |
Connection |
Возвращает или задает строку, содержащую сведения о подключении для таблицы запросов. Объект чтения и записи. (Унаследовано от _QueryTable) |
Creator |
Возвращает константу в перечислении XlCreator , указывающую приложение, в котором был создан этот объект. Если объект был создан в Microsoft Excel, это свойство возвращает строку XCEL, эквивалентную шестнадцатеричной цифре 5843454C. Только для XlCreatorчтения . (Унаследовано от _QueryTable) |
Destination |
Возвращает ячейку в левом верхнем углу диапазона назначения таблицы запросов (диапазон, в котором будет размещена результирующая таблица запроса). Диапазон назначения должен находиться на листе, который содержит QueryTable объект . Диапазон только для чтения. (Унаследовано от _QueryTable) |
EditWebPage |
Возвращает или задает URL-адрес веб-страницы для веб-запроса. Объект чтения и записи. (Унаследовано от _QueryTable) |
EnableEditing |
Значение true , если пользователь может изменить указанную таблицу запросов. False , если пользователь может обновить только таблицу запросов. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
EnableRefresh |
Значение true , если пользователь может обновить кэш сводной таблицы или таблицу запросов. Значение по умолчанию — True. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
FetchedRowOverflow |
Значение true , если количество строк, возвращенных последним использованием Refresh(Object) метода, больше, чем количество строк, доступных на листе. Только для чтения, Boolean. (Унаследовано от _QueryTable) |
FieldNames |
Значение true, если имена полей из источника данных отображаются в виде заголовков столбцов для возвращаемых данных. Значение по умолчанию — True. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
FillAdjacentFormulas |
Значение true , если формулы справа от указанной таблицы запросов обновляются автоматически при каждом обновлении таблицы запросов. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
HasAutoFormat |
Зарезервировано для внутреннего использования. (Унаследовано от _QueryTable) |
ListObject |
ListObject Возвращает объект для Range объекта или QueryTable объекта . Объект ListObject , доступный только для чтения. (Унаследовано от _QueryTable) |
MaintainConnection |
Значение true , если подключение к указанному источнику данных сохраняется после обновления и до закрытия книги. Значение по умолчанию — True. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
Name |
Возвращает или задает имя объекта. Для чтения и записи, String. (Унаследовано от _QueryTable) |
Parameters |
Возвращает коллекцию Parameters , представляющую параметры таблицы запросов. Только для чтения. (Унаследовано от _QueryTable) |
Parent |
Возвращает родительский объект для указанного объекта. Только для чтения. (Унаследовано от _QueryTable) |
PostText |
Возвращает или задает строку, используемую с методом post ввода данных на веб-сервер для возврата данных из веб-запроса. Для чтения и записи, String. (Унаследовано от _QueryTable) |
PreserveColumnInfo |
Значение true , если сведения о сортировке, фильтрации и макете столбцов сохраняются при каждом обновлении таблицы запросов. Значение по умолчанию — False. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
PreserveFormatting |
Это свойство имеет значение True , если к новым строкам данных в таблице запроса применяется любое форматирование, общее для первых пяти строк данных. Неиспользуемые ячейки не форматируются. Свойство имеет значение False, если последний автоформат, примененный к таблице запросов, применяется к новым строкам данных. Значение по умолчанию — True (если только таблица запросов не была создана в Microsoft Excel 97 и HasAutoFormat свойство имеет значение True, в этом случае Параметр PreserveFormatting имеет значение False). Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
QueryType |
Указывает тип запроса, используемого Microsoft Excel для заполнения таблицы запросов или кэша сводной таблицы. Только для XlQueryTypeчтения . (Унаследовано от _QueryTable) |
Recordset |
Возвращает или задает объект Recordset , используемый в качестве источника данных для указанной таблицы запросов или кэша сводной таблицы. Для чтения и записи. (Унаследовано от _QueryTable) |
Refreshing |
Значение true , если выполняется фоновый запрос для указанной таблицы запросов. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
RefreshOnFileOpen |
Значение true , если кэш сводной таблицы или таблица запросов автоматически обновляются при каждом открытии книги. Значение по умолчанию — False. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
RefreshPeriod |
Возвращает или задает количество минут между обновлениями. Для чтения и записи, Integer. (Унаследовано от _QueryTable) |
RefreshStyle |
Возвращает или задает способ добавления или удаления строк на указанном листе для размещения количества строк в наборе записей, возвращаемого запросом. Чтение и запись XlCellInsertionMode. (Унаследовано от _QueryTable) |
ResultRange |
Range Возвращает объект , представляющий область листа, занятую указанной таблицей запросов. Только для чтения. (Унаследовано от _QueryTable) |
RobustConnect |
Возвращает или задает способ подключения кэша сводной таблицы к источнику данных. Чтение и запись XlRobustConnect. (Унаследовано от _QueryTable) |
RowNumbers |
Значение true, если номера строк добавляются в качестве первого столбца указанной таблицы запросов. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
SaveData |
Значение true , если данные для отчета сводной таблицы сохраняются вместе с книгой. False, если сохранено только определение отчета. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
SavePassword |
Значение true, если сведения о пароле в строка подключения ODBC сохраняются с указанным запросом. Значение False , если пароль удален. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
Sort |
Возвращает критерии сортировки для диапазона таблицы запросов. Только для чтения. (Унаследовано от _QueryTable) |
SourceConnectionFile |
Возвращает или задает строку, указывающую файл подключения к данным Microsoft Office или аналогичный файл, который использовался для создания сводной таблицы. Для чтения и записи. (Унаследовано от _QueryTable) |
SourceDataFile |
Возвращает или задает строку, указывающую исходный файл данных для таблицы запросов. (Унаследовано от _QueryTable) |
Sql |
Зарезервировано для внутреннего использования. (Унаследовано от _QueryTable) |
TablesOnlyFromHTML |
Создает таблицу данных на основе входных значений и формул, заданных на листе. (Унаследовано от _QueryTable) |
TextFileColumnDataTypes |
Возвращает или задает упорядоченный массив констант, указывающий типы данных, применяемые к соответствующим столбцам в текстовом файле, импортируемом в таблицу запросов. Константой по умолчанию для каждого столбца является xlGeneral. Объект чтения и записи. (Унаследовано от _QueryTable) |
TextFileCommaDelimiter |
Значение True , если запятая является разделителем при импорте текстового файла в таблицу запросов. Значение False , если вы хотите использовать в качестве разделителя какой-то другой символ. Значение по умолчанию — False. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
TextFileConsecutiveDelimiter |
Значение true, если последовательные разделители обрабатываются как один разделитель при импорте текстового файла в таблицу запросов. Значение по умолчанию — False. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
TextFileDecimalSeparator |
Возвращает или задает символ десятичного разделителя, который Microsoft Excel использует при импорте текстового файла в таблицу запросов. По умолчанию используется системный знак разделителя десятичных разрядов. Для чтения и записи, String. (Унаследовано от _QueryTable) |
TextFileFixedColumnWidths |
Возвращает или задает массив целых чисел, соответствующих ширине столбцов (в символах) в текстовом файле, импортируемом в таблицу запросов. Допустимая ширина составляет от 1 до 32 767 символов. Объект чтения и записи. (Унаследовано от _QueryTable) |
TextFileOtherDelimiter |
Возвращает или задает символ, используемый в качестве разделителя при импорте текстового файла в таблицу запросов. Значение по умолчанию — NULL. Для чтения и записи, String. (Унаследовано от _QueryTable) |
TextFileParseType |
Возвращает или задает формат столбца для данных в текстовом файле, импортируемых в таблицу запросов. Чтение и запись XlTextParsingType. (Унаследовано от _QueryTable) |
TextFilePlatform |
Возвращает или задает источник текстового файла, импортируемого в таблицу запросов. Это свойство определяет, какая кодовая страница используется во время импорта данных. Значение по умолчанию — текущий параметр параметра Источник файла в мастере импорта текстовых файлов. Чтение и запись XlPlatform. (Унаследовано от _QueryTable) |
TextFilePromptOnRefresh |
Значение true , если требуется указать имя импортированного текстового файла при каждом обновлении таблицы запросов. Диалоговое окно Импорт текстового файла позволяет указать путь и имя файла. Значение по умолчанию — False. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
TextFileSemicolonDelimiter |
Значение true , если точка с запятой является разделителем при импорте текстового TextFileParseType файла в таблицу запросов и значение свойства xlDelimited. Значение по умолчанию — False. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
TextFileSpaceDelimiter |
Значение true , если символ пробела является разделителем при импорте текстового файла в таблицу запросов. Значение по умолчанию — False. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
TextFileStartRow |
Возвращает или задает номер строки, с которой начнется синтаксический анализ текста при импорте текстового файла в таблицу запросов. Допустимые значения — это целые числа от 1 до 32 767. Значение по умолчанию равно 1. Для чтения и записи, Integer. (Унаследовано от _QueryTable) |
TextFileTabDelimiter |
Значение True , если символ табуляции является разделителем при импорте текстового файла в таблицу запросов. Значение по умолчанию — False. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
TextFileTextQualifier |
Возвращает или задает квалификатор текста при импорте текстового файла в таблицу запросов. Квалификатор текста указывает, что вложенные данные в текстовом формате. Чтение и запись XlTextQualifier. (Унаследовано от _QueryTable) |
TextFileThousandsSeparator |
Возвращает или задает символ разделителя тысяч, который Microsoft Excel использует при импорте текстового файла в таблицу запросов. По умолчанию используется системный разделитель тысяч. Для чтения и записи, String. (Унаследовано от _QueryTable) |
TextFileTrailingMinusNumbers |
Значение true для Microsoft Excel для обработки импортированных чисел как текста, начинающегося с символа "-" как отрицательного числа. Значение false для Excel для обработки импортированных чисел как текста, которые начинаются с символа "-" как текста. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
TextFileVisualLayout |
Возвращает или задает константу XlTextVisualLayoutType , указывающую, является ли визуальный макет импортируемого текста слева направо или справа налево. (Унаследовано от _QueryTable) |
WebConsecutiveDelimitersAsOne |
Значение true , если последовательные разделители обрабатываются как один разделитель при импорте данных из html-тегов <PRE> на веб-странице в таблицу запросов и если данные должны быть проанализированы по столбцам. Значение False , если требуется обрабатывать последовательные разделители как несколько разделителей. Значение по умолчанию — True. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
WebDisableDateRecognition |
Значение true , если данные, похожие на даты, анализируются как текст при импорте веб-страницы в таблицу запросов. Значение False , если используется распознавание даты. Значение по умолчанию — False. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
WebDisableRedirections |
Значение true, если перенаправления веб-запросов отключены для QueryTable объекта. Значение по умолчанию — False. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
WebFormatting |
Возвращает или задает значение, определяющее, сколько форматирования веб-страницы, если таковое имеется, применяется при импорте страницы в таблицу запросов. Чтение и запись XlWebFormatting. (Унаследовано от _QueryTable) |
WebPreFormattedTextToColumns |
Возвращает или задает значение, указывающее, анализируются ли данные, содержащиеся в тегах HTML <PRE> на веб-странице, по столбцам при импорте страницы в таблицу запросов. По умолчанию используется значение True. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
WebSelectionType |
Возвращает или задает значение, определяющее, импортируются ли в таблицу запроса вся веб-страница, все таблицы на веб-странице или только определенные таблицы на веб-странице. Чтение и запись XlWebSelectionType. (Унаследовано от _QueryTable) |
WebSingleBlockTextImport |
Значение true, если данные из html-тегов <PRE> на указанной веб-странице обрабатываются одновременно при импорте страницы в таблицу запросов. False , если данные импортируются в блоки смежных строк, чтобы строки заголовков распознавались как таковые. Значение по умолчанию — False. Для чтения и записи, Boolean. (Унаследовано от _QueryTable) |
WebTables |
Возвращает или задает разделенный запятыми список имен таблиц или номеров индексов таблиц при импорте веб-страницы в таблицу запроса. Для чтения и записи, String. (Унаследовано от _QueryTable) |
WorkbookConnection |
WorkbookConnection Возвращает объект, который использует таблица запросов. Только для чтения. (Унаследовано от _QueryTable) |
Методы
CancelRefresh() |
Отменяет все фоновые запросы для указанной таблицы запросов. Используйте свойство , Refreshing чтобы определить, выполняется ли фоновый запрос. (Унаследовано от _QueryTable) |
Delete() |
Удаляет объект . (Унаследовано от _QueryTable) |
Refresh(Object) |
Обновления диапазон внешних данных (QueryTable). Логическое значение. (Унаследовано от _QueryTable) |
ResetTimer() |
Сбрасывает таймер обновления для указанной таблицы запросов или отчета сводной таблицы до последнего интервала, заданного RefreshPeriod с помощью свойства . (Унаследовано от _QueryTable) |
SaveAsODC(String, Object, Object) |
Сохраняет источник кэша сводной таблицы как файл подключения к данным Microsoft Office. (Унаследовано от _QueryTable) |
События
AfterRefresh |
Происходит после завершения или отмены запроса. (Унаследовано от RefreshEvents_Event) |
BeforeRefresh |
Происходит перед любым обновлением таблицы запросов. Сюда входят обновления, возникающие в результате вызова метода Refresh , действий пользователя в продукте и открытия книги, содержащей таблицу запросов. (Унаследовано от RefreshEvents_Event) |