QueryTable Интерфейс

Ссылка

Определение

Пространство имен:: Microsoft.Office.Interop.Excel

Сборка:: Microsoft.Office.Interop.Excel.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет таблицу листа, созданную на основе данных, возвращаемых из внешнего источника данных, например 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

Производный: Microsoft.Office.Interop.Excel.QueryTableClass

Атрибуты: GuidAttribute

Реализации: _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)

Применяется к