QueryTable Класс

Определение

Пространство имен:

DocumentFormat.OpenXml.Spreadsheet

Сборка:

DocumentFormat.OpenXml.dll

Пакет:

DocumentFormat.OpenXml v3.0.1

Таблица запросов.

Этот класс доступен в Office 2007 и более поздних версиях.

Когда объект сериализуется как xml, его полное имя — x:queryTable.

public class QueryTable : DocumentFormat.OpenXml.OpenXmlPartRootElement

type QueryTable = class
    inherit OpenXmlPartRootElement

Public Class QueryTable
Inherits OpenXmlPartRootElement

Наследование

Object

OpenXmlElement

OpenXmlCompositeElement

OpenXmlPartRootElement

QueryTable

Комментарии

[ISO/IEC 29500-1 1 издание]

queryTable (таблица запросов)

Этот элемент задает все соответствующие свойства для таблицы запросов. Один элемент таблицы запроса хранится для каждого объекта таблицы запроса в документе spreadsheetML.

Родительские элементы
Корневой элемент части таблицы запросов SpreadsheetML

Дочерние элементы	Вложенные запросы
extLst (область хранения данных о будущих компонентах)	§18.2.10
queryTableRefresh (Сведения об обновлении таблицы QueryTable)	§18.12.6

Атрибуты	Описание
adjustColumnWidth (настройка ширины столбца при обновлении)	Указывает, следует ли автоматически настраивать ширину столбцов при обновлении в соответствии с получаемыми данными. Значение true , если необходимо изменить ширину столбцов. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
applyAlignmentFormats (применение форматов выравнивания)	Если значение true, примените устаревшие свойства автоматического выравнивания таблицы. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
applyBorderFormats (применение форматов границ)	Если значение true, примените устаревшие свойства границы таблицы автоформата. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
applyFontFormats (применение форматов шрифтов)	Если значение true, примените устаревшие свойства шрифта для таблицы с автоформатом. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
applyNumberFormats (применение числовых форматов)	Если значение true, примените устаревшие свойства формата чисел. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
applyPatternFormats (применение форматов шаблонов)	Если значение true, примените устаревшие свойства шаблона автоформата таблицы. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
applyWidthHeightFormats (применение форматов ширины и высоты)	Если значение true, примените устаревшие свойства таблицы с автоформатом width/height. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
autoFormatId (auto format id)	Определяет, к какому автоформату таблицы следует применить устаревшую версию. Приложение D содержит список поддерживаемых автоформатов сводной таблицы, примеры форматирования и пример книги с каждым из примененных автоформатов. Возможные значения для этого атрибута определены в типе данных unsignedInt схемы W3C XML.
backgroundRefresh (фоновое обновление)	Указывает, должна ли таблица запросов пытаться обновить данные в фоновом режиме. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
connectionId (идентификатор подключения)	Указывает идентификатор подключения к внешним данным, используемый для обновления данных в таблице запросов. Возможные значения для этого атрибута определены в типе данных unsignedInt схемы W3C XML.
disableEdit (Отключить редактирование)	Указывает, должен ли изменяться элемент подключения, используемый с этой таблицей запросов. Если значение равно true, подключение невозможно изменить. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
disableRefresh (отключить обновление)	Указывает, следует ли обновлять таблицу запросов. Если значение равно true, то таблица запросов не обновляется. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
fillFormulas (заливка смежных формул)	Указывает, следует ли заполнять формулы в столбцах, расположенных рядом с таблицей запросов, при каждом обновлении таблицы запросов. Это полезно, так как количество строк, возвращаемых операцией обновления таблицы запросов, может отличаться. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
firstBackgroundRefresh (первое фоновое обновление)	Указывает, обновлялись ли данные для этой таблицы запросов. Если первое фоновое обновление данных не было завершено во время сохранения файла, для этого атрибута задано значение true. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
growShrinkType (тип grow shrink)	Указывает тип поведения, ожидаемого для работы с переменным числом строк данных в таблице запросов между операциями обновления. Значение возможных значений этого атрибута {insertClear, insertDelete, overwriteClear} подробно описано в определении простого типа. Возможные значения для этого атрибута определяются простым типом ST_GrowShrinkType (§18.18.39).
заголовки (заголовки столбцов первой строки)	Указывает, содержит ли таблица запросов первую строку с заголовками столбцов. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
intermediate (intermediate)	Указывает, находится ли эта таблица запросов в промежуточном состоянии, если она определена, но не полностью сформирована и заполнена данными. В этом состоянии поля и диапазоны таблицы запросов могут быть неизвестными. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
name (QueryTable Name)	Указывает имя таблицы запросов. Возможные значения для этого атрибута определяются ST_Xstring простого типа (§22.9.2.19).
preserveFormatting (сохранение форматирования при обновлении)	Указывает, должно ли приложение пытаться сохранить форматирование в таблице запросов и копировать это форматирование в новые строки данных. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
refreshOnLoad (обновление при загрузке)	Указывает, должна ли таблица запросов автоматически обновлять свои данные при загрузке или открытии документа spreadsheetML. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
removeDataOnSave (удаление данных при сохранении)	Указывает, должна ли таблица запросов удалять все данные с листа перед сохранением документа spreadsheetML. Это очень полезно в ситуациях, когда пользователи с разными разрешениями на просмотр данных хотят предоставить общий доступ к одному документу spreadsheetML. Все данные от последнего пользователя удаляются, а новые пользователи повторно запрашивают внешние источники данных с собственными учетными данными. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
rowNumbers (номера строк)	Указывает, должна ли таблица запросов включать первый столбец с номерами строк. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).

[Примечание. Определение схемы XML W3C для модели содержимого этого элемента (CT_QueryTable) находится в §A.2. конечная заметка]

ISO/IEC29500: 2008.

Конструкторы

QueryTable()	Инициализирует новый экземпляр класса QueryTable.
QueryTable(IEnumerable<OpenXmlElement>)	Инициализирует новый экземпляр класса QueryTable с указанными дочерними элементами.
QueryTable(OpenXmlElement[])	Инициализирует новый экземпляр класса QueryTable с указанными дочерними элементами.
QueryTable(String)	Инициализирует новый экземпляр класса QueryTable из внешнего XML-кода.

Свойства

AdjustColumnWidth	adjustColumnWidth Представляет следующий атрибут в схеме: adjustColumnWidth
ApplyAlignmentFormats	Применение форматов выравнивания Представляет следующий атрибут в схеме: applyAlignmentFormats
ApplyBorderFormats	Применение форматов границ Представляет следующий атрибут в схеме: applyBorderFormats
ApplyFontFormats	Применение форматов шрифтов Представляет следующий атрибут в схеме: applyFontFormats
ApplyNumberFormats	Применить числовые форматы Представляет следующий атрибут в схеме: applyNumberFormats
ApplyPatternFormats	Применение форматов шаблонов Представляет следующий атрибут в схеме: applyPatternFormats
ApplyWidthHeightFormats	Применение форматов ширины и высоты Представляет следующий атрибут в схеме: applyWidthHeightFormats
AutoFormatId	Идентификатор автоматического форматирования Представляет следующий атрибут в схеме: autoFormatId
BackgroundRefresh	backgroundRefresh Представляет следующий атрибут в схеме: backgroundRefresh
ChildElements	Возвращает все дочерние узлы текущего элемента. (Унаследовано от OpenXmlElement)
ConnectionId	connectionId Представляет следующий атрибут в схеме: connectionId
DisableEdit	disableEdit Представляет следующий атрибут в схеме: disableEdit
DisableRefresh	disableRefresh Представляет следующий атрибут в схеме: disableRefresh
ExtendedAttributes	Возвращает все расширенные атрибуты (атрибуты, не определенные в схеме) текущего элемента. (Унаследовано от OpenXmlElement)
Features	IFeatureCollection Возвращает для текущего элемента. Эта коллекция компонентов будет доступна только для чтения, но будет наследовать компоненты от родительской части и пакета, если они доступны. (Унаследовано от OpenXmlElement)
FillFormulas	fillFormulas Представляет следующий атрибут в схеме: fillFormulas
FirstBackgroundRefresh	firstBackgroundRefresh Представляет следующий атрибут в схеме: firstBackgroundRefresh
FirstChild	Получает первый дочерний элемент текущего элемента OpenXmlElement. (Унаследовано от OpenXmlCompositeElement)
GrowShrinkType	growShrinkType Представляет следующий атрибут в схеме: growShrinkType
HasAttributes	Возвращает значение, указывающее, имеет ли текущий элемент какие-либо атрибуты. (Унаследовано от OpenXmlElement)
HasChildren	Возвращает значение, указывающее, содержит ли текущий элемент какие-либо дочерние элементы. (Унаследовано от OpenXmlCompositeElement)
Headers	заголовки Представляет следующий атрибут в схеме: headers
InnerText	Возвращает или задает объединенные значения текущего узла и всех его дочерних элементов. (Унаследовано от OpenXmlCompositeElement)
InnerXml	Возвращает или задает разметку, представляющую только дочерние узлы текущего узла. (Унаследовано от OpenXmlCompositeElement)
Intermediate	Промежуточных Представляет следующий атрибут в схеме: intermediate
LastChild	Возвращает последний дочерний элемент текущего элемента OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если такого элемента OpenXmlElement нет. (Унаследовано от OpenXmlCompositeElement)
LocalName	Возвращает локальное имя текущего элемента. (Унаследовано от OpenXmlElement)
MCAttributes	Возвращает или задает атрибуты совместимости разметки. Возвращает значение NULL, если для текущего элемента не определены атрибуты совместимости разметки. (Унаследовано от OpenXmlElement)
Name	name Представляет следующий атрибут в схеме: name
NamespaceDeclarations	Возвращает все объявления пространства имен, определенные в текущем элементе. Возвращает пустой перечислитель, если нет объявления пространства имен. (Унаследовано от OpenXmlElement)
NamespaceUri	Возвращает универсальный код ресурса (URI) пространства имен текущего элемента. (Унаследовано от OpenXmlElement)
OpenXmlElementContext	Возвращает openXmlElementContext текущего элемента. (Унаследовано от OpenXmlElement)
OpenXmlPart	Возвращает часть, связанную с деревом DOM. Он возвращает значение NULL, если дерево DOM не связано с частью. (Унаследовано от OpenXmlPartRootElement)
OuterXml	Возвращает разметку, представляющую текущий элемент и все его дочерние элементы. (Унаследовано от OpenXmlElement)
Parent	Возвращает родительский элемент текущего элемента. (Унаследовано от OpenXmlElement)
Prefix	Возвращает префикс пространства имен текущего элемента. (Унаследовано от OpenXmlElement)
PreserveFormatting	preserveFormatting Представляет следующий атрибут в схеме: preserveFormatting
QueryTableExtensionList	QueryTableExtensionList. Представляет следующий тег элемента в схеме: x:extLst.
QueryTablePart	Возвращает объект QueryTablePart, связанный с этим элементом.
QueryTableRefresh	QueryTableRefresh. Представляет следующий тег элемента в схеме: x:queryTableRefresh.
RefreshOnLoad	refreshOnLoad Представляет следующий атрибут в схеме: refreshOnLoad
RemoveDataOnSave	removeDataOnSave Представляет следующий атрибут в схеме: removeDataOnSave
RowNumbers	rowNumbers Представляет следующий атрибут в схеме: rowNumbers
XmlQualifiedName	Возвращает полное имя текущего элемента. (Унаследовано от OpenXmlElement)
XName	Возвращает полное имя текущего элемента. (Унаследовано от OpenXmlElement)

Методы

AddAnnotation(Object)	Добавляет объект в список заметок текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
AddChild(OpenXmlElement, Boolean)	Добавляет указанный элемент в элемент , если он является известным дочерним элементом. При этом элемент будет добавлен в правильное расположение в соответствии со схемой. (Унаследовано от OpenXmlCompositeElement)
AddNamespaceDeclaration(String, String)	Добавляет объявление пространства имен в текущий узел. (Унаследовано от OpenXmlElement)
Ancestors()	Перечисляет все предки текущего элемента. (Унаследовано от OpenXmlElement)
Ancestors<T>()	Перечисляет только предки текущего элемента, имеющие указанный тип. (Унаследовано от OpenXmlElement)
Annotation(Type)	Получение первого объекта заметки указанного типа из текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
Annotation<T>()	Получение первого объекта заметки указанного типа из текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
Annotations(Type)	Возвращает коллекцию заметок с указанным типом для текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
Annotations<T>()	Возвращает коллекцию заметок с указанным типом для текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Добавляет каждый элемент из списка элементов в конец списка дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement)
Append(OpenXmlElement[])	Добавляет каждый элемент из массива элементов в конец списка дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement)
AppendChild<T>(T)	Добавляет указанный элемент в конец списка дочерних узлов текущего элемента. (Унаследовано от OpenXmlCompositeElement)
ClearAllAttributes()	Очищает все атрибуты, включая как известные, так и расширенные атрибуты. (Унаследовано от OpenXmlElement)
Clone()	Создает дубликат текущего узла. (Унаследовано от OpenXmlElement)
CloneNode(Boolean)	Создает дубликат этого узла.
Descendants()	Перечисляет все потомки текущего элемента. (Унаследовано от OpenXmlElement)
Descendants<T>()	Перечисление всех потомков текущего элемента типа T. (Унаследовано от OpenXmlElement)
Elements()	Перечисляет все дочерние элементы текущего элемента. (Унаследовано от OpenXmlElement)
Elements<T>()	Перечисляет только дочерние элементы текущего элемента, имеющие указанный тип. (Унаследовано от OpenXmlElement)
ElementsAfter()	Перечисляет все одноуровневые элементы, которые следуют за текущим элементом и имеют тот же родительский элемент, что и текущий элемент. (Унаследовано от OpenXmlElement)
ElementsBefore()	Перечисляет все одноуровневые элементы, которые предшествуют текущему элементу и имеют тот же родительский элемент, что и текущий элемент. (Унаследовано от OpenXmlElement)
GetAttribute(String, String)	Возвращает атрибут Open XML с указанным именем тега и URI пространства имен. (Унаследовано от OpenXmlElement)
GetAttributes()	Возвращает список, содержащий копию всех атрибутов. (Унаследовано от OpenXmlElement)
GetEnumerator()	Возвращает перечислитель, который выполняет итерацию по дочерней коллекции. (Унаследовано от OpenXmlElement)
GetFirstChild<T>()	Находит первый дочерний элемент в типе T. (Унаследовано от OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Вставляет указанный элемент сразу после указанного ссылочного элемента. (Унаследовано от OpenXmlCompositeElement)
InsertAfterSelf<T>(T)	Вставляет указанный элемент сразу после текущего элемента. (Унаследовано от OpenXmlElement)
InsertAt<T>(T, Int32)	Вставляет указанный элемент по указанному индексу дочерних элементов текущего элемента. (Унаследовано от OpenXmlCompositeElement)
InsertBefore<T>(T, OpenXmlElement)	Вставляет указанный элемент непосредственно перед указанным ссылочным элементом. (Унаследовано от OpenXmlCompositeElement)
InsertBeforeSelf<T>(T)	Вставляет указанный элемент непосредственно перед текущим элементом. (Унаследовано от OpenXmlElement)
IsAfter(OpenXmlElement)	Определяет, отображается ли текущий элемент после указанного элемента в порядке документа. (Унаследовано от OpenXmlElement)
IsBefore(OpenXmlElement)	Определяет, отображается ли текущий элемент перед указанным элементом в порядке документа. (Унаследовано от OpenXmlElement)
Load(QueryTablePart)	Загружает DOM из QueryTablePart
LookupNamespace(String)	Разрешает префикс пространства имен в контексте текущего узла. (Унаследовано от OpenXmlElement)
LookupPrefix(String)	Находит соответствующий префикс для URI пространства имен в текущем элементе область. (Унаследовано от OpenXmlElement)
NextSibling()	Возвращает элемент OpenXmlElement, который сразу же следует за текущим элементом OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет следующего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
NextSibling<T>()	Возвращает элемент OpenXmlElement с указанным типом, который следует за текущим элементом OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет следующего OpenXmlElement. (Унаследовано от OpenXmlElement)
PrependChild<T>(T)	Вставляет указанный элемент в начало списка дочерних узлов текущего элемента. (Унаследовано от OpenXmlCompositeElement)
PreviousSibling()	Возвращает элемент OpenXmlElement, который непосредственно предшествует текущему элементу OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет предыдущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
PreviousSibling<T>()	Возвращает элемент OpenXmlElement с указанным типом, который предшествует текущему объекту OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет предыдущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
Reload()	Перезагружает содержимое части в дерево DOM Open XML. Этот метод можно вызвать несколько раз, и при каждом вызове дерево будет перезагружено, а предыдущие изменения в дереве будут отменены. (Унаследовано от OpenXmlPartRootElement)
Remove()	Удаляет текущий элемент из родительского элемента. (Унаследовано от OpenXmlElement)
RemoveAllChildren()	Удаляет все дочерние элементы текущего элемента. (Унаследовано от OpenXmlCompositeElement)
RemoveAllChildren<T>()	Удалите все дочерние элементы текущего элемента типа T. (Унаследовано от OpenXmlElement)
RemoveAnnotations(Type)	Удаляет заметки указанного типа из текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
RemoveAnnotations<T>()	Удаляет заметки с указанным типом из текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
RemoveAttribute(String, String)	Удаляет атрибут из текущего элемента. (Унаследовано от OpenXmlElement)
RemoveChild<T>(T)	Удаляет указанный дочерний элемент. (Унаследовано от OpenXmlCompositeElement)
RemoveNamespaceDeclaration(String)	Удаляет объявление пространства имен для указанного префикса. Ничего не удаляет, если нет префикса. (Унаследовано от OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Заменяет один из дочерних элементов текущего элемента другим элементом OpenXmlElement. (Унаследовано от OpenXmlCompositeElement)
Save()	Сохраняет данные в дереве DOM обратно в часть. Этот метод можно вызывать несколько раз, и при каждом вызове поток будет сбрасываться. (Унаследовано от OpenXmlPartRootElement)
Save(QueryTablePart)	Сохраняет DOM в QueryTablePart.
Save(Stream)	Сохраняет дерево DOM в указанном потоке. (Унаследовано от OpenXmlPartRootElement)
SetAttribute(OpenXmlAttribute)	Задает атрибут заданного элемента. Если атрибут является известным атрибутом, задается значение атрибута. Если атрибут является расширенным атрибутом, в список расширенных атрибутов добавляется openxmlAttribute. (Унаследовано от OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Задает ряд атрибутов элемента . Если атрибут является известным атрибутом, задается значение атрибута. Если атрибут является расширенным атрибутом, в список расширенных атрибутов добавляется openxmlAttribute. (Унаследовано от OpenXmlElement)
WriteTo(XmlWriter)	Сохраняет текущий узел в указанном xmlWriter. (Унаследовано от OpenXmlPartRootElement)

Явные реализации интерфейса

IEnumerable.GetEnumerator()	Таблица запросов. Этот класс доступен в Office 2007 и более поздних версиях. Когда объект сериализуется как xml, его полное имя — x:queryTable. (Унаследовано от OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Возвращает перечислитель, который выполняет итерацию по дочерней коллекции. (Унаследовано от OpenXmlElement)