CellFormula Clase

Definición

Espacio de nombres:

DocumentFormat.OpenXml.Spreadsheet

Ensamblado:

DocumentFormat.OpenXml.dll

Paquete:

DocumentFormat.OpenXml v3.0.1

Fórmula.

Esta clase está disponible en Office 2007 y versiones posteriores.

Cuando el objeto se serializa como xml, su nombre completo es x:f.

public class CellFormula : DocumentFormat.OpenXml.OpenXmlLeafTextElement

type CellFormula = class
    inherit OpenXmlLeafTextElement

Public Class CellFormula
Inherits OpenXmlLeafTextElement

Herencia

Object

OpenXmlElement

OpenXmlLeafElement

OpenXmlLeafTextElement

CellFormula

Comentarios

[ISO/IEC 29500-1 1.ª edición]

f (Fórmula)

Fórmula para la celda. La expresión de fórmula está contenida en el nodo de caracteres de este elemento.

[Ejemplo:

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

Fin del ejemplo]

Los valores posibles para el atributo t se definen mediante el tipo simple ST_CellFormulaType y son los siguientes:

Valor

Descripción

array (fórmula de matriz)

Fórmula de matriz. Una fórmula de matriz es una fórmula única, aplicada en un rango de una o varias celdas. Una fórmula de matriz puede devolver varios resultados de un único cálculo, los resultados que abarcan las celdas en las que está contenida (§18.17.2.7).

dataTable (fórmula de tabla)

Tabla de datos. Una tabla de datos es un rango de celdas que muestra cómo el cambio de determinados valores en una o varias fórmulas afecta a los resultados de esas fórmulas. Una tabla de datos proporciona un acceso directo para calcular varias versiones en una operación y una manera de incluir los resultados de todas las variaciones diferentes en una hoja.

Se pueden crear tablas de datos de variables de una y dos entradas (consulte atributo dt2D). [Ejemplo: se puede usar una tabla de datos de variables de entrada única para calcular cómo afectan las distintas tasas de interés a un pago mensual de la hipoteca, mientras que se puede usar una tabla de datos variables de dos entradas para calcular cómo afectarán las diferentes tasas de interés y términos de préstamo al pago de la hipoteca. Fin del ejemplo]

En una tabla de datos de variables de entrada única, los valores se enumeran en una columna (orientada a columnas) o en una fila (orientada a filas) (vea atributo dtr).

Las fórmulas que se usan en una tabla de datos de variables de entrada deben hacer referencia a una celda de entrada (vea el atributo r1), la celda en la que se sustituye cada valor de entrada de una tabla de datos. Cualquier celda de una hoja de cálculo puede ser la celda de entrada. Aunque la celda de entrada no necesita formar parte de la tabla de datos, las fórmulas de las tablas de datos harán referencia a esa celda de entrada.

Las tablas de datos de variables de dos entradas usan solo una fórmula con dos listas de valores de entrada. La fórmula hará referencia a dos celdas de entrada (consulte los atributos r1 y r2).

La celda superior izquierda de la tabla de datos se denomina celda maestra.

[Guía: se recomienda que las aplicaciones de hoja de cálculo vuelvan a calcular las tablas de datos cada vez que se vuelva a calcular una hoja de cálculo. instrucciones finales]

normal (fórmula normal)

Fórmula de celda normal (§18.17).

shared (fórmula compartida)

Fórmula compartida. Si una celda contiene la misma fórmula que otra celda, se puede usar el valor "shared" para el atributo t y el atributo si se puede usar para hacer referencia a la celda que contiene la fórmula. Se considera que dos fórmulas son las mismas cuando sus respectivas representaciones en la notación de referencia R1C1 son las mismas.

Elementos primarios
c (§18.3.1.4); nc (§18.11.1.3); oc (§18.11.1.5)

Atributos	Descripción
aca (Always Calculate Array)	Solo se aplica a las fórmulas de matriz. true indica que toda la matriz se calculará en su totalidad. Si es false , las celdas individuales de la matriz se calcularán según sea necesario. El valor de aca se omitirá a menos que el valor del atributo t correspondiente sea array. [Nota: El caso principal en el que una fórmula de matriz debe calcularse en parte en lugar de en completo es cuando algunas celdas de la matriz dependen de otras celdas semicompágenas, por ejemplo, contiene la función =(). Fin de la nota] El tipo de datos boolean del esquema XML W3C define los valores posibles para este atributo.
bx (asigna el valor al nombre)	Especifica que esta fórmula asigna un valor a un nombre. El tipo de datos boolean del esquema XML W3C define los valores posibles para este atributo.
ca (calcular celda)	Indica que esta fórmula debe volver a calcularse la próxima vez que se realice el cálculo. [Ejemplo: esto siempre se establece en funciones volátiles, como =() y referencias circulares. Fin del ejemplo] El tipo de datos boolean del esquema XML W3C define los valores posibles para este atributo.
del1 (entrada 1 eliminada)	Si se ha eliminado la primera celda de entrada de la tabla de datos. Solo se aplica a la fórmula de tabla de datos. Escrito solo en la celda maestra de la fórmula de tabla de datos. El tipo de datos boolean del esquema XML W3C define los valores posibles para este atributo.
del2 (entrada 2 eliminada)	Si se ha eliminado la segunda celda de entrada de la tabla de datos. Solo se aplica a la fórmula de tabla de datos. Escrito solo en la celda maestra de la fórmula de tabla de datos. El tipo de datos boolean del esquema XML W3C define los valores posibles para este atributo.
dt2D (tabla de datos 2-D)	La tabla de datos es de dos fases. Solo se aplica a la función de tablas de datos. Escrito solo en la celda maestra de la fórmula de tabla de datos. El tipo de datos boolean del esquema XML W3C define los valores posibles para este atributo.
dtr (fila tabla de datos)	true si la tabla de datos de un solo valor es una fila; de lo contrario, es una columna. Solo se aplica a la función de tablas de datos. Escrito solo en la celda maestra de la fórmula de tabla de datos. El tipo de datos boolean del esquema XML W3C define los valores posibles para este atributo.
r1 (celda de tabla de datos 1)	Primera celda de entrada para la tabla de datos. Solo se aplica a la función de matriz de tablas de datos "TABLE()". Escrito solo en la celda maestra de la fórmula de tabla de datos. Los valores posibles para este atributo se definen mediante el ST_CellRef tipo simple (§18.18.7).
r2 (celda de entrada 2)	Segunda celda de entrada para la tabla de datos cuando dt2D es "1". Solo se aplica a la función de matriz de tablas de datos "TABLE()". Escrito solo en la celda maestra de la fórmula de tabla de datos. Los valores posibles para este atributo se definen mediante el ST_CellRef tipo simple (§18.18.7).
ref (Rango de celdas)	Rango de celdas al que se aplica la fórmula. Solo es necesario para la fórmula compartida, la fórmula de matriz o la tabla de datos. Solo se escribe en la fórmula maestra, no en las fórmulas posteriores que pertenecen al mismo grupo compartido, matriz o tabla de datos. Los valores posibles para este atributo se definen mediante el ST_Ref tipo simple (§18.18.62).
si (índice de grupo compartido)	Atributo opcional para optimizar el rendimiento de carga mediante el uso compartido de fórmulas. Cuando una fórmula es una fórmula compartida (se comparte el valor t), este valor indica el grupo al que pertenece la fórmula de esta celda determinada. La primera fórmula de un grupo de fórmulas compartidas se guarda en el elemento f. Esto se considera la celda de fórmula "maestra". Las celdas posteriores que comparten esta fórmula no necesitan tener la fórmula escrita en su elemento f. En su lugar, el valor del atributo si de una celda determinada se usa para calcular cuál debe ser la expresión de fórmula en función de la ubicación relativa de la celda a la celda de fórmula maestra. Una celda solo se comparte cuando se usa si y t se comparte. La expresión de fórmula de una celda que se especifica para formar parte de una fórmula compartida (y no es la maestra) se omitirá y la fórmula maestra se invalidará. Si una celda maestra de un intervalo de fórmulas compartidas especifica que una celda determinada forma parte del intervalo de fórmulas compartidas y esa celda determinada no usa los atributos si y t para indicar que se comparte, la fórmula de la celda determinada invalidará la fórmula maestra compartida. Si esta celda se produce en medio de un rango de celdas de fórmula compartidas, las fórmulas anteriores y posteriores seguirán compartiendo la fórmula maestra, y la celda en cuestión no compartirá la fórmula de la fórmula de celda maestra. Se define la implementación de la carga y el control de una celda y una fórmula mediante un atributo si y cuyo valor t se comparte, ubicado fuera del intervalo especificado en la celda maestra asociada al grupo si. Las referencias de celda maestra en la misma hoja no se superpondrán entre sí. Los valores posibles para este atributo los define el tipo de datos unsignedInt del esquema XML W3C.
t (tipo de fórmula)	Tipo de fórmula. Los valores posibles para este atributo se definen mediante el ST_CellFormulaType tipo simple (§18.18.6).

[Nota: La definición del esquema XML W3C del modelo de contenido de este elemento (CT_CellFormula) se encuentra en §A.2. Fin de la nota]

ISO/IEC29500: 2008.

Constructores

CellFormula()	Inicializa una nueva instancia de la clase CellFormula.
CellFormula(String)	Inicializa una nueva instancia de la clase CellFormula con el contenido de texto especificado.

Propiedades

AlwaysCalculateArray	Calcular siempre matriz Representa el atributo siguiente en el esquema: aca
Bx	Asigna valor a nombre Representa el atributo siguiente en el esquema: bx
CalculateCell	Calcular celda Representa el atributo siguiente en el esquema: ca
ChildElements	Obtiene todos los nodos secundarios del elemento actual. (Heredado de OpenXmlElement)
DataTable2D	Tabla de datos 2-D Representa el atributo siguiente en el esquema: dt2D
DataTableRow	Fila de tabla de datos Representa el atributo siguiente en el esquema: dtr
ExtendedAttributes	Obtiene todos los atributos extendidos (atributos no definidos en el esquema) del elemento actual. (Heredado de OpenXmlElement)
Features	Obtiene un IFeatureCollection para el elemento actual. Esta colección de características será de solo lectura, pero heredará características de su elemento primario y paquete si está disponible. (Heredado de OpenXmlElement)
FirstChild	Obtiene el primer elemento secundario del elemento OpenXmlElement. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement de este tipo. (Heredado de OpenXmlElement)
FormulaType	Tipo de fórmula Representa el atributo siguiente en el esquema: t
HasAttributes	Obtiene un valor que indica si el elemento actual tiene atributos. (Heredado de OpenXmlElement)
HasChildren	Obtiene un valor que indica si el elemento actual tiene algún elemento secundario. (Heredado de OpenXmlLeafTextElement)
InnerText	Obtiene o establece los valores concatenados del elemento y todos sus elementos secundarios. (Heredado de OpenXmlLeafTextElement)
InnerXml	Obtiene o establece el marcado que solo representa elementos secundarios del elemento actual. (Heredado de OpenXmlLeafTextElement)
Input1Deleted	Entrada 1 eliminada Representa el atributo siguiente en el esquema: del1
Input2Deleted	Entrada 2 eliminada Representa el atributo siguiente en el esquema: del2
LastChild	Obtiene el último elemento secundario del elemento OpenXmlElement. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement de este tipo. (Heredado de OpenXmlElement)
LocalName	Obtiene el nombre local del elemento actual. (Heredado de OpenXmlElement)
MCAttributes	Obtiene o establece los atributos de compatibilidad de marcado. Devuelve null si no se definen atributos de compatibilidad de marcado para el elemento actual. (Heredado de OpenXmlElement)
NamespaceDeclarations	Obtiene todas las declaraciones de espacio de nombres definidas en el elemento actual. Devuelve un enumerador vacío si no hay ninguna declaración de espacio de nombres. (Heredado de OpenXmlElement)
NamespaceUri	Obtiene el URI del espacio de nombres del elemento actual. (Heredado de OpenXmlElement)
OpenXmlElementContext	Obtiene el Objeto OpenXmlElementContext del elemento actual. (Heredado de OpenXmlElement)
OuterXml	Obtiene el marcado que representa el elemento actual y todos sus elementos secundarios. (Heredado de OpenXmlElement)
Parent	Obtiene el elemento primario del elemento actual. (Heredado de OpenXmlElement)
Prefix	Obtiene el prefijo de espacio de nombres del elemento actual. (Heredado de OpenXmlElement)
R1	Celda de tabla de datos 1 Representa el atributo siguiente en el esquema: r1
R2	Celda de entrada 2 Representa el atributo siguiente en el esquema: r2
Reference	Rango de celdas Representa el atributo siguiente en el esquema: ref
SharedIndex	Índice de grupo compartido Representa el atributo siguiente en el esquema: si
Space	El contenido contiene un espacio en blanco significativo Representa el atributo siguiente en el esquema: xml:space
Text	Obtiene o establece el texto del elemento actual. (Heredado de OpenXmlLeafTextElement)
XmlQualifiedName	Obtiene el nombre completo del elemento actual. (Heredado de OpenXmlElement)
XName	Obtiene el nombre completo del elemento actual. (Heredado de OpenXmlElement)

Métodos

AddAnnotation(Object)	Agrega un objeto a la lista de anotaciones del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
AddNamespaceDeclaration(String, String)	Agrega una declaración de espacio de nombres al nodo actual. (Heredado de OpenXmlElement)
Ancestors()	Enumera todos los antecesores del elemento actual. (Heredado de OpenXmlElement)
Ancestors<T>()	Enumera solo los antecesores del elemento actual que tienen el tipo especificado. (Heredado de OpenXmlElement)
Annotation(Type)	Obtenga el primer objeto de anotación del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotation<T>()	Obtenga el primer objeto de anotación del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotations(Type)	Obtiene una colección de anotaciones con el tipo especificado para el elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Annotations<T>()	Obtiene una colección de anotaciones con el tipo especificado para el elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Anexa cada elemento de una lista de elementos al final de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
Append(OpenXmlElement[])	Anexa cada elemento de una matriz de elementos al final de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
AppendChild<T>(T)	Anexa el elemento especificado al final de la lista de nodos secundarios del elemento actual. (Heredado de OpenXmlElement)
ClearAllAttributes()	Borra todos los atributos, incluidos los atributos conocidos y los atributos extendidos. (Heredado de OpenXmlElement)
Clone()	Crea un duplicado del nodo actual. (Heredado de OpenXmlElement)
CloneNode(Boolean)	Crea un duplicado de este nodo.
Descendants()	Enumera todos los descendientes del elemento actual. (Heredado de OpenXmlElement)
Descendants<T>()	Enumera todos los descendientes del elemento actual del tipo T. (Heredado de OpenXmlElement)
Elements()	Enumera todos los elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
Elements<T>()	Enumera solo los elementos secundarios del elemento actual que tienen el tipo especificado. (Heredado de OpenXmlElement)
ElementsAfter()	Enumera todos los elementos del mismo nivel que siguen el elemento actual y tienen el mismo elemento primario que el elemento actual. (Heredado de OpenXmlElement)
ElementsBefore()	Enumera todos los elementos del mismo nivel que preceden al elemento actual y tienen el mismo elemento primario que el elemento actual. (Heredado de OpenXmlElement)
GetAttribute(String, String)	Obtiene un atributo Open XML con el nombre de etiqueta y el URI de espacio de nombres especificados. (Heredado de OpenXmlElement)
GetAttributes()	Obtiene una lista que contiene una copia de todos los atributos. (Heredado de OpenXmlElement)
GetEnumerator()	Devuelve un enumerador que recorre en iteración la colección secundaria. (Heredado de OpenXmlElement)
GetFirstChild<T>()	Busca el primer elemento secundario en el tipo T. (Heredado de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Inserta el elemento especificado inmediatamente después del elemento de referencia especificado. (Heredado de OpenXmlElement)
InsertAfterSelf<T>(T)	Inserta el elemento especificado inmediatamente después del elemento actual. (Heredado de OpenXmlElement)
InsertAt<T>(T, Int32)	Inserta el elemento especificado en el índice especificado en la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	Inserta el elemento especificado inmediatamente antes del elemento de referencia especificado. (Heredado de OpenXmlElement)
InsertBeforeSelf<T>(T)	Inserta el elemento especificado inmediatamente antes del elemento actual. (Heredado de OpenXmlElement)
IsAfter(OpenXmlElement)	Determina si el elemento actual aparece después de un elemento especificado en el orden del documento. (Heredado de OpenXmlElement)
IsBefore(OpenXmlElement)	Determina si el elemento actual aparece antes que un elemento especificado en el orden del documento. (Heredado de OpenXmlElement)
LookupNamespace(String)	Resuelve el prefijo de espacio de nombres en el contexto del nodo actual. (Heredado de OpenXmlElement)
LookupPrefix(String)	Busca el prefijo correspondiente para un uri de espacio de nombres en el ámbito del elemento actual. (Heredado de OpenXmlElement)
NextSibling()	Obtiene el elemento OpenXmlElement que sigue inmediatamente al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement siguiente. (Heredado de OpenXmlElement)
NextSibling<T>()	Obtiene el elemento OpenXmlElement con el tipo especificado que sigue al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement siguiente. (Heredado de OpenXmlElement)
PrependChild<T>(T)	Inserta el elemento especificado al principio de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
PreviousSibling()	Obtiene el elemento OpenXmlElement que precede inmediatamente al elemento OpenXmlElement actual. Devuelve null (Nothing en Visual Basic ) si no hay ningún elemento OpenXmlElement anterior. (Heredado de OpenXmlElement)
PreviousSibling<T>()	Obtiene el elemento OpenXmlElement con el tipo especificado que precede al objeto OpenXmlElement actual. Devuelve null (Nothing en Visual Basic) si no hay ningún elemento OpenXmlElement anterior. (Heredado de OpenXmlElement)
Remove()	Quita el elemento actual de su elemento primario. (Heredado de OpenXmlElement)
RemoveAllChildren()	Quita todos los elementos secundarios del elemento actual. (Heredado de OpenXmlLeafTextElement)
RemoveAllChildren<T>()	Quite todos los elementos secundarios del elemento actual que son de tipo T. (Heredado de OpenXmlElement)
RemoveAnnotations(Type)	Quita las anotaciones del tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
RemoveAnnotations<T>()	Quita las anotaciones con el tipo especificado del elemento OpenXmlElement actual. (Heredado de OpenXmlElement)
RemoveAttribute(String, String)	Quita el atributo del elemento actual. (Heredado de OpenXmlElement)
RemoveChild<T>(T)	Quita el elemento secundario especificado de la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
RemoveNamespaceDeclaration(String)	Quita la declaración de espacio de nombres para el prefijo especificado. No quita nada si no hay ningún prefijo. (Heredado de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Reemplaza un elemento secundario por otro elemento secundario en la lista de elementos secundarios del elemento actual. (Heredado de OpenXmlElement)
SetAttribute(OpenXmlAttribute)	Establece un atributo en el elemento especificado. Si el atributo es un atributo conocido, se establece el valor del atributo. Si el atributo es un atributo extendido, el atributo "openxmlAttribute" se agrega a la lista de atributos extendidos. (Heredado de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Establece una serie de atributos en el elemento . Si un atributo es un atributo conocido, se establece el valor del atributo. Si un atributo es un atributo extendido, el atributo "openxmlAttribute" se agrega a la lista de atributos extendidos. (Heredado de OpenXmlElement)
WriteTo(XmlWriter)	Guarda el nodo actual en el objeto XmlWriter especificado. (Heredado de OpenXmlElement)

Implementaciones de interfaz explícitas

IEnumerable.GetEnumerator()	Fórmula. Esta clase está disponible en Office 2007 y versiones posteriores. Cuando el objeto se serializa como xml, su nombre completo es x:f. (Heredado de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Devuelve un enumerador que recorre en iteración la colección secundaria. (Heredado de OpenXmlElement)