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定义，如下所示：

值

说明

数组 (数组公式)

数组公式。 数组公式是单个公式，应用于一个或多个单元格区域。 数组公式可以从一个计算返回多个结果，结果跨越包含它的单元格 (§18.17.2.7) 。

dataTable (表公式)

模拟运算表。 数据表是一个单元格区域，显示更改一个或多个公式中的某些值如何影响这些公式的结果。 数据表提供了在一个操作中计算多个版本的快捷方式，以及一种在工作表中包含所有不同变体的结果的方法。

可以创建单输入和双输入变量数据表， (请参阅属性 dt2D) 。[示例：单输入变量数据表可用于计算不同的利率对每月抵押贷款付款的影响，而双输入变量数据表可用于计算不同的利率和贷款条件对抵押贷款付款的影响。 示例结束]

在单输入变量数据表中，值在列 (面向列) 或跨行列出， (面向行) (请参阅属性 dtr) 。

单输入变量数据表中使用的公式应引用输入单元格 (请参阅属性 r1) ，其中替换了数据表中的每个输入值的单元格。 工作表上的任何单元格都可以是输入单元格。 尽管输入单元格不需要是数据表的一部分，但数据表中的公式应引用该输入单元格。

双输入变量数据表仅使用一个公式，其中包含两个输入值列表。 公式应引用两个输入单元格， (请参阅属性 r1 和 r2) 。

数据表中的左上角单元格称为 主单元格。

[指导：建议每当重新计算工作表时，电子表格应用程序都重新计算数据表。 结束指南]

normal (Normal 公式)

普通单元格公式 (§18.17) 。

共享 (共享公式)

共享公式。 如果单元格包含与另一个单元格相同的公式，则“共享”值可用于 t 属性，si 属性可用于引用包含该公式的单元格。 当两个公式在 R1C1 引用表示法中的各自表示形式相同时，它们被视为相同。

父元素
c (§18.3.1.4) ;nc (§18.11.1.3) ;oc (§18.11.1.5)

属性	说明
aca (Always Calculate Array)	仅适用于数组公式。 true 指示应完整计算整个数组。 如果 为 false ，则应根据需要计算数组的单个单元格。 除非相应 t 属性的值是数组，否则应忽略 aca 值。 [注意：数组公式必须部分而不是完整计算的主要情况是数组中的某些单元格依赖于半计算的其他单元格，例如，包含函数 = () 。 注释结束] 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
bx (将值分配给名称)	指定此公式将值分配给名称。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
ca (计算单元格)	指示下次执行计算时需要重新计算此公式。 [示例：这始终在可变函数（如 = () ）和循环引用上设置。 示例结束] 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
del1 (输入 1 已删除)	是否已删除数据表的第一个输入单元格。 仅适用于数据表公式。 仅在数据表公式的主单元格上写入。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
del2 (输入 2 已删除)	是否已删除数据表的第二个输入单元格。 仅适用于数据表公式。 仅在数据表公式的主单元格上写入。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
dt2D (数据表 2-D)	数据表为两维。 仅适用于数据表函数。 仅在数据表公式的主单元格上写入。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
dtr (数据表行)	如果一维数据表是一行，则为 true，否则为列。 仅适用于数据表函数。 仅在数据表公式的主单元格上写入。 此属性可能的值由 W3C XML 架构 boolean 数据类型定义。
r1 (数据表单元格 1)	数据表的第一个输入单元格。 仅适用于数据表数组函数“TABLE () ”。 仅在数据表公式的主单元格上写入。 此属性的可能值由 ST_CellRef 简单类型 (§18.18.7) 定义。
r2 (输入单元格 2)	当 dt2D 为“1”时，数据表的第二个输入单元格。 仅适用于数据表数组函数“TABLE () ”。仅在数据表公式的主单元格上写入。 此属性的可能值由 ST_CellRef 简单类型 (§18.18.7) 定义。
ref (单元格区域)	公式应用于的单元格区域。 仅共享公式、数组公式或数据表需要。 仅在主公式上写入，而不是属于同一共享组、数组或数据表的后续公式。 此属性的可能值由 ST_Ref 简单类型 (§18.18.62) 定义。
si (共享组索引)	用于通过共享公式优化负载性能的可选属性。 当公式是共享公式 (t 值 共享) 则此值指示此特定单元格的公式所属的组。 一组共享公式中的第一个公式保存在 f 元素中。 这被视为“主公式”单元格。 共享此公式的后续单元格无需在其 f 元素中编写公式。 相反，特定单元格的属性 si 值用于根据单元格与主公式单元格的相对位置来计算公式表达式应是什么。 仅当使用 si 且共享 t 时，才会 共享单元格。 应忽略指定为共享公式的一部分且不是主公式 () 的单元格的公式表达式，并且主公式应替代。 如果共享公式区域的主单元格指定特定单元格是共享公式区域的一部分，并且该特定单元格不使用 si 和 t 属性来指示共享，则特定单元格的公式应替代共享的主公式。 如果此单元格位于一系列共享公式单元格的中间，则早期和更高版本的公式将继续共享主公式，并且相关单元格不应共享主单元格公式的公式。 使用 si 属性加载和处理单元格和公式，其 t 值 是共享的，位于与 si 组关联的主单元格中指定的范围之外，是实现定义的。 同一工作表上的主单元格引用不应相互重叠。 此属性的可能值由 W3C XML 架构 unsignedInt 数据类型定义。
t (公式类型)	公式的类型。 此属性的可能值由 ST_CellFormulaType 简单类型 (§18.18.6) 定义。

[注意：此元素的内容模型 (CT_CellFormula) 的 W3C XML 架构定义位于 §A.2 中。 注释结束]

ISO/IEC29500：2008。

构造函数

CellFormula()	初始化 CellFormula 类的新实例。
CellFormula(String)	使用指定的文本内容初始化 CellFormula 类的新实例。

属性

AlwaysCalculateArray	Always Calculate Array 表示架构中的以下属性：aca
Bx	将值赋给名称 表示架构中的以下属性：bx
CalculateCell	计算单元格 表示架构中的以下属性： ca
ChildElements	获取当前元素的所有子节点。 (继承自 OpenXmlElement)
DataTable2D	数据表 2-D 表示架构中的以下属性：dt2D
DataTableRow	数据表行 表示架构中的以下属性：dtr
ExtendedAttributes	获取当前元素的架构) 中未定义的所有扩展属性 (属性。 (继承自 OpenXmlElement)
Features	IFeatureCollection获取当前元素的 。 此功能集合将是只读的，但会从其父部件和包继承功能（如果可用）。 (继承自 OpenXmlElement)
FirstChild	获取 OpenXmlElement 元素的第一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
FormulaType	公式类型 表示架构中的以下属性： t
HasAttributes	获取一个值，该值指示当前元素是否具有任何属性。 (继承自 OpenXmlElement)
HasChildren	获取一个值，该值指示当前元素是否具有任何子元素。 (继承自 OpenXmlLeafTextElement)
InnerText	获取或设置元素及其所有子元素的串联值。 (继承自 OpenXmlLeafTextElement)
InnerXml	获取或设置仅表示当前元素的子元素的标记。 (继承自 OpenXmlLeafTextElement)
Input1Deleted	输入 1 已删除 表示架构中的以下属性：del1
Input2Deleted	输入 2 已删除 表示架构中的以下属性：del2
LastChild	获取 OpenXmlElement 元素的最后一个子元素。 如果没有这样的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 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)	获取具有指定标记名称和命名空间 URI 的 Open XML 属性。 (继承自 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 元素。 如果没有下一个 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
NextSibling<T>()	获取具有当前 OpenXmlElement 元素后面的指定类型的 OpenXmlElement 元素。 如果没有下一个 OpenXmlElement，则返回 null (Visual Basic) Nothing。 (继承自 OpenXmlElement)
PrependChild<T>(T)	在当前元素的子元素列表的开头插入指定的元素。 (继承自 OpenXmlElement)
PreviousSibling()	获取紧接在当前 OpenXmlElement 元素之前的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic ) 中 Nothing。 (继承自 OpenXmlElement)
PreviousSibling<T>()	获取位于当前 OpenXmlElement 之前的指定类型的 OpenXmlElement 元素。 如果没有前面的 OpenXmlElement 元素，则返回 null (Visual Basic) Nothing。 (继承自 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)