PivotSelection Класс

Определение

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

DocumentFormat.OpenXml.Spreadsheet

Сборка:

DocumentFormat.OpenXml.dll

Пакет:

DocumentFormat.OpenXml v3.0.1

Выбор сводной таблицы.

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

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

public class PivotSelection : DocumentFormat.OpenXml.OpenXmlCompositeElement

type PivotSelection = class
    inherit OpenXmlCompositeElement

Public Class PivotSelection
Inherits OpenXmlCompositeElement

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

Object

OpenXmlElement

OpenXmlCompositeElement

PivotSelection

Комментарии

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

pivotSelection (PivotTable Selection)

Коллекция выбранных структур сводной таблицы. Выбор структуры сводной таблицы — это способ указания выбранных ячеек в сводной таблице. Вместо указания адресов ячеек в sqref указывается определенная область или структура в сводной таблице. Таким образом, имеется семантическое значение, связанное с выбранным, а не просто список ячеек или диапазонов, содержащихся в выделенном фрагменте. Обычно поля на оси строк или столбцов выбираются.

[Пример. Например, в этой сводной таблице выбрано самое внутреннее поле (подкатегория продукта):

69bf0087-c567-4d34-88db-014e53f7bae8

Соответствующий XML-код сводного выбора должен выглядеть следующим образом:

<pivotSelection pane="bottomRight" showHeader="1" axis="axisRow" dimension="2"  activeRow="11" activeCol="1" previousRow="11" previousCol="1" click="1"   r:id="rId1">  
  <pivotArea dataOnly="0" labelOnly="1" fieldPosition="0">  
    <references count="1">  
      <reference field="9" count="0"/>  
    </references>  
  </pivotArea>  
</pivotSelection>  

ось указывает, что этот выбор находится на оси строк, измерение указывает уровень поля в выбранной оси строк (индекс с отсчитываемого от нуля), activeCol и activeRow соответственно указывает, где в сетке находится выделенный фрагмент, а поле ссылки указывает, к какому конкретному полю соответствует выборка.

конец примера

Родительские элементы
sheetView (§18.3.1.87)

Дочерние элементы	Вложенные запросы
PivotArea (область сводной таблицы)	§18.3.1.68

Атрибуты	Описание
activeCol (активный столбец)	Столбец (отсчитываемый от нуля) активной ячейки для выбора структуры. Возможные значения для этого атрибута определены в типе данных unsignedInt схемы W3C XML.
activeRow (активная строка)	Строка (отсчитываемая от нуля) активной ячейки для выбора структуры. Возможные значения для этого атрибута определены в типе данных unsignedInt схемы W3C XML.
ось (Ось)	Ось сводной таблицы, на которой находится этот выбор. Возможные значения для этого атрибута определяются ST_Axis простого типа (§18.18.1).
click (Количество щелчков)	Количество щелчков для выбора структуры. Для некоторых сочетаний выбора последующие щелчки в той же целевой области цикличен фактический выбор с помощью некоторых отклонений. Таким образом, количество щелчков по выделенному фрагменту должно быть записано, если требуется восстановить это состояние цикла выделения при загрузке. Возможные значения для этого атрибута определены в типе данных unsignedInt схемы W3C XML.
count (Selection Count)	Количество выделенных элементов для выбора структуры. Возможные значения для этого атрибута определены в типе данных unsignedInt схемы W3C XML.
data (выбор данных)	Флаг, указывающий, предназначен ли выбор структуры только для данных. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
измерение (измерение)	Указывает уровень поля в выбранной оси (отсчитываемый от нуля индекс). Возможные значения для этого атрибута определены в типе данных unsignedInt схемы W3C XML.
расширяемый (расширяемый)	Флаг, указывающий, могут ли к выделенной структуре добавляться дополнительные выделенные фрагменты. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
id (идентификатор связи) Пространство имен: .../officeDocument/2006/relationships	Идентификатор связи, указывающий на определенную часть сводной таблицы, соответствующую этому выбору. Возможные значения для этого атрибута определяются простым типом ST_RelationshipId (§22.8.2.1).
label (Label)	Флаг, указывающий, выбрана ли структура только для меток (например, выбрана общая строка). Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
max (maximum)	Максимальная строка, которая содержится в выбранной структуре. Возможные значения для этого атрибута определены в типе данных unsignedInt схемы W3C XML.
min (минимум)	Минимальная строка, которая содержится в выбранной структуре. Возможные значения для этого атрибута определены в типе данных unsignedInt схемы W3C XML.
панель (область)	Область, к которой принадлежит выбор структуры сводной таблицы. Возможные значения для этого атрибута определяются ST_Pane простого типа (§18.18.52).
previousCol (выбор предыдущего столбца)	Индекс на основе 1 в столбце, непосредственно слева от выделенной структуры. Возможные значения для этого атрибута определены в типе данных unsignedInt схемы W3C XML.
previousRow (предыдущая строка)	1 индекс в строку непосредственно над выбранным элементом структуры. Возможные значения для этого атрибута определены в типе данных unsignedInt схемы W3C XML.
showHeader (Показать заголовок)	Флаг, указывающий, включен ли переключатель выделения только из данных в заголовок к обоим. Значение False означает отключено. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
start (Start)	Строка, в основе выборки структуры начинается (от нуля). Это строка, нажатая для запуска выбора структуры. Возможные значения для этого атрибута определены в типе данных unsignedInt схемы W3C XML.

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

ISO/IEC29500: 2008.

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

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

Свойства

ActiveColumn	Активный столбец Представляет следующий атрибут в схеме: activeCol
ActiveRow	Активная строка Представляет следующий атрибут в схеме: activeRow
Axis	Axis Представляет следующий атрибут в схеме: ось
ChildElements	Возвращает все дочерние узлы текущего элемента. (Унаследовано от OpenXmlElement)
Click	Нажмите кнопку Count (Счетчик) Представляет следующий атрибут в схеме: click
Count	Количество выделений Представляет следующий атрибут в схеме: count
Data	Выбор данных Представляет следующий атрибут в схеме: data
Dimension	Dimension Представляет следующий атрибут в схеме: измерение
Extendable	Выдвижная Представляет следующий атрибут в схеме: расширяемый
ExtendedAttributes	Возвращает все расширенные атрибуты (атрибуты, не определенные в схеме) текущего элемента. (Унаследовано от OpenXmlElement)
Features	IFeatureCollection Возвращает для текущего элемента. Эта коллекция компонентов будет доступна только для чтения, но будет наследовать компоненты от родительской части и пакета, если они доступны. (Унаследовано от OpenXmlElement)
FirstChild	Получает первый дочерний элемент текущего элемента OpenXmlElement. (Унаследовано от OpenXmlCompositeElement)
HasAttributes	Возвращает значение, указывающее, имеет ли текущий элемент какие-либо атрибуты. (Унаследовано от OpenXmlElement)
HasChildren	Возвращает значение, указывающее, содержит ли текущий элемент какие-либо дочерние элементы. (Унаследовано от OpenXmlCompositeElement)
Id	Идентификатор связи Представляет следующий атрибут в схеме: r:id
InnerText	Возвращает или задает объединенные значения текущего узла и всех его дочерних элементов. (Унаследовано от OpenXmlCompositeElement)
InnerXml	Возвращает или задает разметку, представляющую только дочерние узлы текущего узла. (Унаследовано от OpenXmlCompositeElement)
Label	Label Представляет следующий атрибут в схеме: label
LastChild	Возвращает последний дочерний элемент текущего элемента OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если такого элемента OpenXmlElement нет. (Унаследовано от OpenXmlCompositeElement)
LocalName	Возвращает локальное имя текущего элемента. (Унаследовано от OpenXmlElement)
Max	Максимальный Представляет следующий атрибут в схеме: max
MCAttributes	Возвращает или задает атрибуты совместимости разметки. Возвращает значение NULL, если для текущего элемента не определены атрибуты совместимости разметки. (Унаследовано от OpenXmlElement)
Min	Minimum Представляет следующий атрибут в схеме: min
NamespaceDeclarations	Возвращает все объявления пространства имен, определенные в текущем элементе. Возвращает пустой перечислитель, если нет объявления пространства имен. (Унаследовано от OpenXmlElement)
NamespaceUri	Возвращает универсальный код ресурса (URI) пространства имен текущего элемента. (Унаследовано от OpenXmlElement)
OpenXmlElementContext	Возвращает openXmlElementContext текущего элемента. (Унаследовано от OpenXmlElement)
OuterXml	Возвращает разметку, представляющую текущий элемент и все его дочерние элементы. (Унаследовано от OpenXmlElement)
Pane	Оконное стекло Представляет следующий атрибут в области схемы:
Parent	Возвращает родительский элемент текущего элемента. (Унаследовано от OpenXmlElement)
PivotArea	Область сводной таблицы. Представляет следующий тег элемента в схеме: x:pivotArea.
Prefix	Возвращает префикс пространства имен текущего элемента. (Унаследовано от OpenXmlElement)
PreviousColumn	Выбор предыдущего столбца Представляет следующий атрибут в схеме: previousCol
PreviousRow	Предыдущая строка Представляет следующий атрибут в схеме: previousRow
ShowHeader	Показать заголовок Представляет следующий атрибут в схеме: showHeader
Start	Начало Представляет следующий атрибут в схеме: start
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)
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)
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)
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)
SetAttribute(OpenXmlAttribute)	Задает атрибут заданного элемента. Если атрибут является известным атрибутом, задается значение атрибута. Если атрибут является расширенным атрибутом, в список расширенных атрибутов добавляется openxmlAttribute. (Унаследовано от OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Задает ряд атрибутов элемента . Если атрибут является известным атрибутом, задается значение атрибута. Если атрибут является расширенным атрибутом, в список расширенных атрибутов добавляется openxmlAttribute. (Унаследовано от OpenXmlElement)
WriteTo(XmlWriter)	Сохраняет текущий узел в указанном xmlWriter. (Унаследовано от OpenXmlElement)

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

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