CellFormula Класс

Определение

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

DocumentFormat.OpenXml.Spreadsheet

Сборка:

DocumentFormat.OpenXml.dll

Пакет:

DocumentFormat.OpenXml v3.0.1

Формула.

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

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

public class CellFormula : DocumentFormat.OpenXml.OpenXmlLeafTextElement

type CellFormula = class
    inherit OpenXmlLeafTextElement

Public Class CellFormula
Inherits OpenXmlLeafTextElement

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

Object

OpenXmlElement

OpenXmlLeafElement

OpenXmlLeafTextElement

CellFormula

Комментарии

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

f (формула)

Формула ячейки. Выражение формулы содержится в узле символов этого элемента.

[Пример:

<f>  
SUM(C4:E4)</f>  

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

Возможные значения для атрибута t определяются простым типом ST_CellFormulaType и следующим образом:

Значение

Описание

array (формула массива)

Формула массива. Формула массива — это одна формула, применяемая в диапазоне из одной или нескольких ячеек. Формула массива может возвращать несколько результатов одного вычисления, охватывающих ячейки, в которых она содержится (§18.17.2.7).

dataTable (формула таблицы)

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

Можно создать таблицы данных с одним и двумя входными переменными (см. атрибут dt2D). [Пример. Таблица данных с одним вводом переменных может использоваться для вычисления того, как различные процентные ставки влияют на ежемесячный платеж по ипотеке, в то время как таблица данных с двумя входными переменными может использоваться для расчета того, как различные процентные ставки и условия кредита повлияют на платеж по ипотеке. конец примера

В таблице данных с одной входной переменной значения перечисляются вниз по столбцу (в столбце) или по строке (ориентированной на строки) (см. атрибут dtr).

Формулы, используемые в таблице данных с одной переменной, должны ссылаться на входную ячейку (см. атрибут r1), ячейку, в которой заменяется каждое входное значение из таблицы данных. Любая ячейка на листе может быть входной ячейкой. Хотя входная ячейка не обязательно должна быть частью таблицы данных, формулы в таблицах данных должны ссылаться на эту входную ячейку.

Таблицы данных с двумя входными переменными используют только одну формулу с двумя списками входных значений. Формула должна ссылаться на две входные ячейки (см. атрибуты r1 и r2).

Верхняя левая ячейка в таблице данных называется ячейкой master.

[Руководство. Приложениям электронной таблицы рекомендуется пересчитывать таблицы данных при каждом пересчете листа. руководство по завершению]

normal (обычная формула)

Формула обычной ячейки (§18.17).

shared (общая формула)

Общая формула. Если ячейка содержит ту же формулу, что и другая ячейка, для атрибута t можно использовать значение shared, а атрибут si — для ссылки на ячейку, содержащую формулу. Две формулы считаются одинаковыми, если их соответствующие представления в нотации ссылки R1C1 одинаковы.

Родительские элементы
c (§18.3.1.4); nc (§18.11.1.3); oc (§18.11.1.5)

Атрибуты	Описание
aca (массив Always Calculate)	Применяется только к формулам массива. Значение true указывает, что весь массив должен вычисляться полностью. Если значение false , отдельные ячейки массива вычисляются по мере необходимости. Значение aca должно игнорироваться, если значение соответствующего атрибута t не является массивом. [Примечание. Основной случай, когда формула массива должна вычисляться частично, а не полностью, это когда некоторые ячейки в массиве зависят от других ячеек, которые являются полусчитаемыми, например, содержит функцию =(). конечная заметка] Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
bx (присваивает значение имени)	Указывает, что эта формула присваивает значение имени. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
ca (calculate cell)	Указывает, что эта формула должна быть пересчитана при следующем выполнении вычисления. [Пример. Этот параметр всегда устанавливается для переменных функций, таких как =(), и циклических ссылок. конец примера Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
del1 (входные данные 1 удалены)	Удалена ли первая входная ячейка для таблицы данных. Применяется только к формуле таблицы данных. Записывается только в master ячейку формулы таблицы данных. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
del2 (входные данные 2 удалены)	Удалена ли вторая входная ячейка для таблицы данных. Применяется только к формуле таблицы данных. Записывается только в master ячейку формулы таблицы данных. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
dt2D (таблица данных 2-D)	Таблица данных является двухдиментной. Применяется только к функции таблиц данных. Записывается только в master ячейку формулы таблицы данных. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
dtr (строка таблицы данных)	Значение true , если однократная таблица данных является строкой, в противном случае — столбцом. Применяется только к функции таблиц данных. Записывается только в master ячейку формулы таблицы данных. Возможные значения этого атрибута определены типом данных boolean схемы XML (консорциум W3C).
r1 (ячейка таблицы данных 1)	Первая входная ячейка для таблицы данных. Применяется только к функции массива таблиц данных "TABLE()". Записывается только в master ячейку формулы таблицы данных. Возможные значения для этого атрибута определяются простым типом ST_CellRef (§18.18.7).
r2 (входная ячейка 2)	Вторая входная ячейка для таблицы данных, если dt2D имеет значение "1". Применяется только к функции массива таблиц данных "TABLE()". Записывается только в master ячейку формулы таблицы данных. Возможные значения для этого атрибута определяются простым типом ST_CellRef (§18.18.7).
ссылка (диапазон ячеек)	Диапазон ячеек, к которым применяется формула. Требуется только для общей формулы, формулы массива или таблицы данных. Записывается только на master формулы, а не последующие формулы, принадлежащие одной общей группе, массиву или таблице данных. Возможные значения для этого атрибута определяются простым типом ST_Ref (§18.18.62).
si (индекс общей группы)	Необязательный атрибут для оптимизации производительности нагрузки путем совместного использования формул. Если формула является общей формулой (значение t является общим), то это значение указывает группу, к которой принадлежит формула данной конкретной ячейки. Первая формула в группе общих формул сохраняется в элементе f. Это считается ячейкой формулы "master". В последующих ячейках, в которых используется эта формула, формула не должна быть записана в элементе f. Вместо этого значение атрибута si для конкретной ячейки используется для определения того, какое выражение формулы должно быть основано на относительном расположении ячейки master ячейки формулы. Ячейка является общей, только если используется si, а t — общий доступ. Выражение формулы для ячейки, которая является частью общей формулы (и не является master), должна игнорироваться, и формула master должна переопределяться. Если master ячейка общего диапазона формул указывает, что определенная ячейка является частью общего диапазона формул, и эта конкретная ячейка не использует атрибуты si и t для указания того, что она является общей, то формула конкретной ячейки должна переопределить общую формулу master. Если эта ячейка содержится в середине диапазона общих ячеек формулы, более ранние и более поздние формулы будут продолжать совместно использовать формулу master, и ячейка, о которой идет речь, не должна совместно использовать формулу master ячейки. Определена реализация загрузки и обработки ячейки и формулы с помощью атрибута si и общего значения t, расположенного за пределами диапазона, указанного в master ячейке, связанной с группой si. Ссылки на главные ячейки на одном листе не должны перекрываться друг с другом. Возможные значения для этого атрибута определены в типе данных unsignedInt схемы W3C XML.
t (тип формулы)	Тип формулы. Возможные значения для этого атрибута определяются простым типом ST_CellFormulaType (§18.18.6).

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

ISO/IEC29500: 2008.

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

CellFormula()	Инициализирует новый экземпляр класса CellFormula.
CellFormula(String)	Инициализирует новый экземпляр класса CellFormula с указанным текстовым содержимым.

Свойства

AlwaysCalculateArray	Всегда вычислять массив Представляет следующий атрибут в схеме: aca
Bx	Присваивает значение имени Представляет следующий атрибут в схеме: bx
CalculateCell	Вычисляемая ячейка Представляет следующий атрибут в схеме: ca
ChildElements	Возвращает все дочерние узлы текущего элемента. (Унаследовано от OpenXmlElement)
DataTable2D	Таблица данных 2-D Представляет следующий атрибут в схеме: dt2D
DataTableRow	Строка таблицы данных Представляет следующий атрибут в схеме: dtr
ExtendedAttributes	Возвращает все расширенные атрибуты (атрибуты, не определенные в схеме) текущего элемента. (Унаследовано от OpenXmlElement)
Features	IFeatureCollection Возвращает для текущего элемента. Эта коллекция компонентов будет доступна только для чтения, но будет наследовать компоненты от родительской части и пакета, если они доступны. (Унаследовано от OpenXmlElement)
FirstChild	Возвращает первый дочерний элемент элемента OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если такого элемента OpenXmlElement нет. (Унаследовано от OpenXmlElement)
FormulaType	Тип формулы Представляет следующий атрибут в схеме: t
HasAttributes	Возвращает значение, указывающее, имеет ли текущий элемент какие-либо атрибуты. (Унаследовано от OpenXmlElement)
HasChildren	Возвращает значение, указывающее, содержит ли текущий элемент какие-либо дочерние элементы. (Унаследовано от OpenXmlLeafTextElement)
InnerText	Возвращает или задает объединенные значения элемента и всех его дочерних элементов. (Унаследовано от OpenXmlLeafTextElement)
InnerXml	Возвращает или задает разметку, представляющую только дочерние элементы текущего элемента. (Унаследовано от OpenXmlLeafTextElement)
Input1Deleted	Входные данные 1 Удалены Представляет следующий атрибут в схеме: del1
Input2Deleted	Входные данные 2 Удалены Представляет следующий атрибут в схеме: del2
LastChild	Возвращает последний дочерний элемент элемента OpenXmlElement. Возвращает значение NULL (Nothing в Visual Basic), если такого элемента OpenXmlElement нет. (Унаследовано от OpenXmlElement)
LocalName	Возвращает локальное имя текущего элемента. (Унаследовано от OpenXmlElement)
MCAttributes	Возвращает или задает атрибуты совместимости разметки. Возвращает значение NULL, если для текущего элемента не определены атрибуты совместимости разметки. (Унаследовано от OpenXmlElement)
NamespaceDeclarations	Возвращает все объявления пространства имен, определенные в текущем элементе. Возвращает пустой перечислитель, если нет объявления пространства имен. (Унаследовано от OpenXmlElement)
NamespaceUri	Возвращает универсальный код ресурса (URI) пространства имен текущего элемента. (Унаследовано от OpenXmlElement)
OpenXmlElementContext	Возвращает openXmlElementContext текущего элемента. (Унаследовано от OpenXmlElement)
OuterXml	Возвращает разметку, представляющую текущий элемент и все его дочерние элементы. (Унаследовано от OpenXmlElement)
Parent	Возвращает родительский элемент текущего элемента. (Унаследовано от OpenXmlElement)
Prefix	Возвращает префикс пространства имен текущего элемента. (Унаследовано от OpenXmlElement)
R1	Ячейка таблицы данных 1 Представляет следующий атрибут в схеме: r1
R2	Входная ячейка 2 Представляет следующий атрибут в схеме: r2
Reference	Диапазон ячеек Представляет следующий атрибут в схеме: ref
SharedIndex	Индекс общей группы Представляет следующий атрибут в схеме: si
Space	Содержимое содержит значительные пробелы Представляет следующий атрибут в схеме: xml:space
Text	Возвращает или задает текст текущего элемента. (Унаследовано от OpenXmlLeafTextElement)
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()	Удаляет все дочерние элементы текущего элемента. (Унаследовано от OpenXmlLeafTextElement)
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:f. (Унаследовано от OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Возвращает перечислитель, который выполняет итерацию по дочерней коллекции. (Унаследовано от OpenXmlElement)