RangeSet Класс

Определение

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

DocumentFormat.OpenXml.Spreadsheet

Сборка:

DocumentFormat.OpenXml.dll

Пакет:

DocumentFormat.OpenXml v3.0.1

Набор диапазонов.

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

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

public class RangeSet : DocumentFormat.OpenXml.OpenXmlLeafElement

type RangeSet = class
    inherit OpenXmlLeafElement

Public Class RangeSet
Inherits OpenXmlLeafElement

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

Object

OpenXmlElement

OpenXmlLeafElement

RangeSet

Комментарии

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

rangeSet (Range Set)

Представляет один диапазон в коллекции rangeSets. Элемент предназначен для упрощения создания отчета сводной таблицы путем консолидации диапазонов SpreadsheetML, которые имеют аналогичные категории данных для суммирования. Самый простой макет для источника данных заключается в том, чтобы каждый диапазон Наборы данных были в формате, похожем на список, с метками столбцов в первой строке, метками строк в первом столбце, остальные строки с похожими элементами в одной строке и столбце и без пустых строк или столбцов в диапазоне. Конкретный rangeSet может состоять из встроенного именованного диапазона, предоставляемого приложением, определяемого пользователем именованного диапазона, ссылки на диапазон или ссылки на внешнюю книгу.

При объединении нескольких диапазонов с помощью этой функции можно создать до 4 настраиваемых фильтров отчета (также известных как поля страницы), чтобы помочь отфильтровать отчет сводной таблицы, в частности, выбрав один или несколько отдельных диапазонов в фильтре отчета. Для каждого созданного поля настраиваемой страницы можно указать настраиваемую метку и назначить ее каждому диапазону, участвуя в диапазоне консолидации, чтобы сводная таблица могла фильтроваться по одному или нескольким обобщаемым диапазонам.

[Пример. Рассмотрим книгу с 6 листами. На листе 1 у нас есть:

00cfa900-e26c-47f7-af92-700036912181

На листе 2 у нас есть:

c6bee0fb-5844-4b3e-b9ed-403edbfcee23

… и т. д. до Листа 5.

На листе 6 у нас есть объединенные диапазоны, суммируемые сводной таблицей, а для сводной таблицы существуют два фильтра страниц.

8a269c06-dfb2-4f3a-8061-b81d3d1f02af

Обратите внимание, что для второго фильтра страницы элементам назначена пользовательская метка "one", "two", ..., "five" для каждого из источников данных Sheet1, Sheet2, ..., Sheet5 соответственно. Аналогичным образом элементам назначена пользовательская метка "1", "2", ..., "5" для каждого из источников данных Sheet1, Sheet2, ..., Shet5 соответственно.

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

<cacheSource type="consolidation">  
  <consolidation autoPage="0">  
    <pages count="2">  
      <page count="5">  
        <pageItem name="1"/>  
        <pageItem name="2"/>  
        <pageItem name="3"/>  
        <pageItem name="4"/>  
        <pageItem name="5"/>  
      </page>  
      <page count="5">  
        <pageItem name="one"/>  
        <pageItem name="two"/>  
        <pageItem name="three"/>  
        <pageItem name="four"/>  
        <pageItem name="five"/>  
      </page>  
    </pages>  
    <rangeSets count="5">  
      <rangeSet i1="0" i2="0" ref="A1:B3" sheet="Sheet1"/>  
      <rangeSet i1="1" i2="1" ref="A1:B3" sheet="Sheet2"/>  
      <rangeSet i1="2" i2="2" ref="A1:B3" sheet="Sheet3"/>  
      <rangeSet i1="3" i2="3" ref="A1:B3" sheet="Sheet4"/>  
      <rangeSet i1="4" i2="4" ref="A1:B3" sheet="Sheet5"/>  
    </rangeSets>  
  </consolidation>  
</cacheSource>  

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

[Примечание. Атрибуты i1, i2, i3 и i4 соответствуют настраиваемым полям страницы, созданным в пользовательском интерфейсе. Электронная таблица ML поддерживает только 4 настраиваемых поля страницы. конечная заметка]

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

Атрибуты	Описание
i1 (страница индекса элемента поля 1)	Задает индекс элемента поля страницы в фильтре страницы. Возможные значения для этого атрибута определены в типе данных unsignedInt схемы W3C XML.
i2 (страница индекса элемента поля 2)	Задает индекс элемента поля страницы в фильтре двух страниц. Возможные значения для этого атрибута определены в типе данных unsignedInt схемы W3C XML.
i3 (индекс элемента поля, страница 3)	Указывает индекс элемента поля страницы в фильтре 3 страницы. Возможные значения для этого атрибута определены в типе данных unsignedInt схемы W3C XML.
i4 (страница индекса элемента поля 4)	Задает индекс элемента поля страницы в фильтре страницы четыре. Возможные значения для этого атрибута определены в типе данных unsignedInt схемы W3C XML.
id (идентификатор связи) Пространство имен: .../officeDocument/2006/relationships	Указывает уникальный идентификатор части книги, в которой хранится набор диапазонов. Дополнительные сведения см. в разделе Книга (§18.2). Возможные значения для этого атрибута определяются простым типом ST_RelationshipId (§22.8.2.1).
name (именованный диапазон)	Указывает именованный диапазон. Возможные значения для этого атрибута определяются ST_Xstring простого типа (§22.9.2.19).
ссылка (ссылка)	Задает диапазон ячеек. Возможные значения для этого атрибута определяются простым типом ST_Ref (§18.18.62).
лист (имя листа)	Указывает имя листа. Возможные значения для этого атрибута определяются ST_Xstring простого типа (§22.9.2.19).

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

ISO/IEC29500: 2008.

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

RangeSet()

Инициализирует новый экземпляр класса RangeSet.

Свойства

ChildElements	Возвращает все дочерние узлы текущего элемента. (Унаследовано от OpenXmlElement)
ExtendedAttributes	Возвращает все расширенные атрибуты (атрибуты, не определенные в схеме) текущего элемента. (Унаследовано от OpenXmlElement)
Features	IFeatureCollection Возвращает для текущего элемента. Эта коллекция компонентов будет доступна только для чтения, но будет наследовать компоненты от родительской части и пакета, если они доступны. (Унаследовано от OpenXmlElement)
FieldItemIndexPage1	Страница индекса элемента поля 1 Представляет следующий атрибут в схеме: i1
FieldItemIndexPage2	Страница индекса элемента поля 2 Представляет следующий атрибут в схеме: i2
FieldItemIndexPage3	Индекс элемента поля: страница 3 Представляет следующий атрибут в схеме: i3
FieldItemIndexPage4	Страница индекса элемента поля 4 Представляет следующий атрибут в схеме: i4
FirstChild	Возвращает первый дочерний элемент элемента OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если такого элемента OpenXmlElement нет. (Унаследовано от OpenXmlElement)
HasAttributes	Возвращает значение, указывающее, имеет ли текущий элемент какие-либо атрибуты. (Унаследовано от OpenXmlElement)
HasChildren	Возвращает значение, указывающее, содержит ли текущий элемент какие-либо дочерние элементы. (Унаследовано от OpenXmlLeafElement)
Id	Идентификатор связи Представляет следующий атрибут в схеме: r:id
InnerText	Возвращает или задает объединенные значения узла и всех его дочерних элементов. (Унаследовано от OpenXmlElement)
InnerXml	Возвращает или задает разметку, представляющую только дочерние элементы текущего элемента. (Унаследовано от OpenXmlLeafElement)
LastChild	Возвращает последний дочерний элемент элемента OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если такого элемента OpenXmlElement нет. (Унаследовано от OpenXmlElement)
LocalName	Возвращает локальное имя текущего элемента. (Унаследовано от OpenXmlElement)
MCAttributes	Возвращает или задает атрибуты совместимости разметки. Возвращает значение NULL, если для текущего элемента не определены атрибуты совместимости разметки. (Унаследовано от OpenXmlElement)
Name	Именованный диапазон Представляет следующий атрибут в схеме: name
NamespaceDeclarations	Возвращает все объявления пространства имен, определенные в текущем элементе. Возвращает пустой перечислитель, если нет объявления пространства имен. (Унаследовано от OpenXmlElement)
NamespaceUri	Возвращает универсальный код ресурса (URI) пространства имен текущего элемента. (Унаследовано от OpenXmlElement)
OpenXmlElementContext	Возвращает openXmlElementContext текущего элемента. (Унаследовано от OpenXmlElement)
OuterXml	Возвращает разметку, представляющую текущий элемент и все его дочерние элементы. (Унаследовано от OpenXmlElement)
Parent	Возвращает родительский элемент текущего элемента. (Унаследовано от OpenXmlElement)
Prefix	Возвращает префикс пространства имен текущего элемента. (Унаследовано от OpenXmlElement)
Reference	Ссылка Представляет следующий атрибут в схеме: ref
Sheet	Имя листа Представляет следующий атрибут в схеме: лист
XmlQualifiedName	Возвращает полное имя текущего элемента. (Унаследовано от OpenXmlElement)
XName	Возвращает полное имя текущего элемента. (Унаследовано от OpenXmlElement)

Методы

AddAnnotation(Object)	Добавляет объект в список заметок текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
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)	Добавляет указанный элемент в конец списка дочерних узлов текущего элемента. (Унаследовано от OpenXmlElement)
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)	Вставляет указанный элемент сразу после указанного ссылочного элемента. (Унаследовано от OpenXmlElement)
InsertAfterSelf<T>(T)	Вставляет указанный элемент сразу после текущего элемента. (Унаследовано от OpenXmlElement)
InsertAt<T>(T, Int32)	Вставляет указанный элемент по указанному индексу в список дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	Вставляет указанный элемент непосредственно перед указанным ссылочным элементом. (Унаследовано от OpenXmlElement)
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)	Вставляет указанный элемент в начало списка дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement)
PreviousSibling()	Возвращает элемент OpenXmlElement, который непосредственно предшествует текущему элементу OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет предыдущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
PreviousSibling<T>()	Возвращает элемент OpenXmlElement с указанным типом, который предшествует текущему объекту OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если нет предыдущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
Remove()	Удаляет текущий элемент из родительского элемента. (Унаследовано от OpenXmlElement)
RemoveAllChildren()	Удаляет все дочерние элементы текущего элемента. (Унаследовано от OpenXmlLeafElement)
RemoveAllChildren<T>()	Удалите все дочерние элементы текущего элемента типа T. (Унаследовано от OpenXmlElement)
RemoveAnnotations(Type)	Удаляет заметки указанного типа из текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
RemoveAnnotations<T>()	Удаляет заметки с указанным типом из текущего элемента OpenXmlElement. (Унаследовано от OpenXmlElement)
RemoveAttribute(String, String)	Удаляет атрибут из текущего элемента. (Унаследовано от OpenXmlElement)
RemoveChild<T>(T)	Удаляет указанный дочерний элемент из списка дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement)
RemoveNamespaceDeclaration(String)	Удаляет объявление пространства имен для указанного префикса. Ничего не удаляет, если нет префикса. (Унаследовано от OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Заменяет дочерний элемент другим дочерним элементом в списке дочерних элементов текущего элемента. (Унаследовано от OpenXmlElement)
SetAttribute(OpenXmlAttribute)	Задает атрибут заданного элемента. Если атрибут является известным атрибутом, задается значение атрибута. Если атрибут является расширенным атрибутом, в список расширенных атрибутов добавляется openxmlAttribute. (Унаследовано от OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Задает ряд атрибутов элемента . Если атрибут является известным атрибутом, задается значение атрибута. Если атрибут является расширенным атрибутом, в список расширенных атрибутов добавляется openxmlAttribute. (Унаследовано от OpenXmlElement)
WriteTo(XmlWriter)	Сохраняет текущий узел в указанном xmlWriter. (Унаследовано от OpenXmlElement)

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

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