CellFormula Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fórmula.
Esta classe está disponível no Office 2007 e superior.
Quando o objeto é serializado como xml, seu nome qualificado é x:f.
[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
[DocumentFormat.OpenXml.SchemaAttr(22, "f")]
public class CellFormula : DocumentFormat.OpenXml.OpenXmlLeafTextElementpublic class CellFormula : DocumentFormat.OpenXml.OpenXmlLeafTextElement[DocumentFormat.OpenXml.SchemaAttr(22, "f")]
public class CellFormula : DocumentFormat.OpenXml.OpenXmlLeafTextElement[DocumentFormat.OpenXml.SchemaAttr("x:f")]
public class CellFormula : DocumentFormat.OpenXml.OpenXmlLeafTextElement[DocumentFormat.OpenXml.SchemaAttr("x:f")]
public class CellFormula : DocumentFormat.OpenXml.TypedOpenXmlLeafTextElement[DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)]
public class CellFormula : DocumentFormat.OpenXml.OpenXmlLeafTextElement[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
[<DocumentFormat.OpenXml.SchemaAttr(22, "f")>]
type CellFormula = class
inherit OpenXmlLeafTextElementtype CellFormula = class
inherit OpenXmlLeafTextElement[<DocumentFormat.OpenXml.SchemaAttr(22, "f")>]
type CellFormula = class
inherit OpenXmlLeafTextElement[<DocumentFormat.OpenXml.SchemaAttr("x:f")>]
type CellFormula = class
inherit OpenXmlLeafTextElement[<DocumentFormat.OpenXml.SchemaAttr("x:f")>]
type CellFormula = class
inherit TypedOpenXmlLeafTextElement[<DocumentFormat.OpenXml.OfficeAvailability(DocumentFormat.OpenXml.FileFormatVersions.Office2007)>]
type CellFormula = class
inherit OpenXmlLeafTextElementPublic Class CellFormula
Inherits OpenXmlLeafTextElementPublic Class CellFormula
Inherits TypedOpenXmlLeafTextElement- Herança
- Herança
- Atributos
Comentários
[ISO/IEC 29500-1 1st Edition]
f (Fórmula)
Fórmula para a célula. A expressão da fórmula está contida no nó de caractere desse elemento.
[Exemplo:
<f>
SUM(C4:E4)</f>
exemplo de término]
Os valores possíveis para o atributo t são definidos pelo tipo simples ST_CellFormulaType e são os seguintes:
Valor
Descrição
matriz (fórmula de matriz)
Fórmula de matriz. Uma fórmula de matriz é uma fórmula única, aplicada em um intervalo de uma ou mais células. Uma fórmula de matriz pode retornar vários resultados de um único cálculo, os resultados abrangendo as células nas quais ela está contida (§18.17.2.7).
dataTable (fórmula de tabela)
Tabela de dados. Uma tabela de dados é um intervalo de células que mostra como a alteração de certos valores em uma ou mais fórmulas afeta os resultados dessas fórmulas. Uma tabela de dados fornece um atalho para calcular várias versões em uma operação e uma maneira de incluir os resultados de todas as diferentes variações em uma planilha.
Tabelas de dados variáveis de uma e duas entradas podem ser criadas (ver atributo dt2D). [Exemplo: uma tabela de dados variáveis de uma entrada pode ser usada para calcular como diferentes taxas de juros afetam um pagamento mensal de hipoteca, enquanto uma tabela de dados variáveis de duas entradas pode ser usada para calcular como diferentes taxas de juros e prazos de empréstimo afetarão o pagamento da hipoteca. exemplo de término]
Em uma tabela de dados variáveis de uma entrada, os valores são listados em uma coluna (orientada por coluna) ou em uma linha (orientada por linha) (consulte o atributo dtr).
As fórmulas usadas em uma tabela de dados variáveis de entrada única devem se referir a uma célula de entrada (consulte o atributo r1), a célula na qual cada valor de entrada de uma tabela de dados é substituído. Qualquer célula em uma planilha pode ser a célula de entrada. Embora a célula de entrada não precise fazer parte da tabela de dados, as fórmulas nas tabelas de dados devem se referir a essa célula de entrada.
As tabelas de dados variáveis de duas entradas usam apenas uma fórmula com duas listas de valores de entrada. A fórmula deve referir-se a duas células de entrada (ver atributos r1 e r2).
A célula superior esquerda na tabela de dados é chamada de célula master.
[Diretrizes: recomenda-se que os aplicativos de planilhas recalculem as tabelas de dados sempre que uma planilha for recalculada. diretrizes de término]
normal (fórmula Normal)
Fórmula da célula normal (§18.17).
compartilhado (fórmula compartilhada)
Fórmula compartilhada. Se uma célula contiver a mesma fórmula que outra célula, o valor "compartilhado" poderá ser usado para o atributo t e o atributo si poderá ser usado para se referir à célula que contém a fórmula. Duas fórmulas são consideradas iguais quando suas respectivas representações na notação de referência R1C1 são as mesmas.
| Elementos pai |
|---|
| c (§18.3.1.4); NC (§18.11.1.3); oc (§18.11.1.5) |
| Atributos | Descrição |
|---|---|
| aca (Always Calculate Array) | Aplica-se somente a fórmulas de matriz.
true indica que toda a matriz deve ser calculada por completo. Se for false , as células individuais da matriz devem ser calculadas conforme necessário. O valor aca deve ser ignorado, a menos que o valor do atributo t correspondente seja array. [Observação: o caso principal em que uma fórmula de matriz deve ser calculada em parte em vez de na íntegra é quando algumas células da matriz dependem de outras células semi-calculadas, por exemplo, contém a função =(). nota final] Os valores possíveis para esse atributo são definidos pelo tipo de dados booleano do esquema XML do W3C. |
| bx (Atribui valor ao nome) | Especifica que essa fórmula atribui um valor a um nome. Os valores possíveis para esse atributo são definidos pelo tipo de dados booleano do esquema XML do W3C. |
| ca (Calcular Célula) | Indica que essa fórmula precisa ser recalculada na próxima vez que o cálculo for executado. [Exemplo: Isso é sempre definido em funções voláteis, como =() e referências circulares.
exemplo de término] Os valores possíveis para esse atributo são definidos pelo tipo de dados booleano do esquema XML do W3C. |
| del1 (entrada 1 excluída) | Se a primeira célula de entrada da tabela de dados foi excluída. Aplica-se somente à fórmula da tabela de dados. Escrito apenas na célula master da fórmula da tabela de dados. Os valores possíveis para esse atributo são definidos pelo tipo de dados booleano do esquema XML do W3C. |
| del2 (entrada 2 excluída) | Se a segunda célula de entrada da tabela de dados foi excluída. Aplica-se somente à fórmula da tabela de dados. Escrito apenas na célula master da fórmula da tabela de dados. Os valores possíveis para esse atributo são definidos pelo tipo de dados booleano do esquema XML do W3C. |
| dt2D (Tabela de Dados 2-D) | A tabela de dados é bidimensional. Aplica-se somente à função de tabelas de dados. Escrito apenas na célula master da fórmula da tabela de dados. Os valores possíveis para esse atributo são definidos pelo tipo de dados booleano do esquema XML do W3C. |
| DTR (Linha da Tabela de Dados) |
True se a tabela de dados unidimensionais for uma linha, caso contrário, será uma coluna. Aplica-se somente à função de tabelas de dados. Escrito apenas na célula master da fórmula da tabela de dados. Os valores possíveis para esse atributo são definidos pelo tipo de dados booleano do esquema XML do W3C. |
| r1 (Tabela de Dados Célula 1) | Primeira célula de entrada para tabela de dados. Aplica-se apenas à função de matriz de tabelas de dados "TABLE()". Escrito apenas na célula master da fórmula da tabela de dados. Os valores possíveis para esse atributo são definidos pelo tipo ST_CellRef simples (§18.18.7). |
| r2 (célula de entrada 2) | Segunda célula de entrada para tabela de dados quando dt2D é '1'. Aplica-se apenas à função de matriz de tabelas de dados "TABLE()". Escrito apenas na célula master da fórmula da tabela de dados. Os valores possíveis para esse atributo são definidos pelo tipo ST_CellRef simples (§18.18.7). |
| ref (Intervalo de Células) | Intervalo de células ao qual a fórmula se aplica. Necessário apenas para fórmula compartilhada, fórmula de matriz ou tabela de dados. Escritos somente na fórmula master, e não em fórmulas subsequentes pertencentes ao mesmo grupo, matriz ou tabela de dados compartilhada. Os valores possíveis para esse atributo são definidos pelo tipo simples ST_Ref (§18.18.62). |
| si (Índice de Grupo Compartilhado) | Atributo opcional para otimizar o desempenho da carga compartilhando fórmulas. Quando uma fórmula é uma fórmula compartilhada (o valor t é compartilhado), esse valor indica o grupo ao qual a fórmula dessa célula específica pertence. A primeira fórmula em um grupo de fórmulas compartilhadas é salva no elemento f. Esta é considerada a célula de fórmula "master". As células subsequentes que compartilham essa fórmula não precisam ter a fórmula escrita em seu elemento f. Em vez disso, o valor do atributo si para uma determinada célula é usado para descobrir qual deve ser a expressão da fórmula com base na localização relativa da célula à célula da fórmula master. Uma célula é compartilhada somente quando si é usado e t é compartilhado. A expressão da fórmula de uma célula especificada para fazer parte de uma fórmula compartilhada (e não for a master) deve ser ignorada e a fórmula master deve ser substituída. Se uma célula master de um intervalo de fórmulas compartilhadas especificar que uma determinada célula faz parte do intervalo de fórmulas compartilhadas e essa célula específica não usar os atributos si e t para indicar que ela é compartilhada, a fórmula da célula específica substituirá a fórmula master compartilhada. Se essa célula ocorrer no meio de um intervalo de células de fórmula compartilhadas, as fórmulas anteriores e posteriores continuarão compartilhando a fórmula master, e a célula em questão não compartilhará a fórmula da fórmula da célula master. O carregamento e o manuseio de uma célula e fórmula usando um atributo si e cujo valor t é compartilhado, localizado fora do intervalo especificado na célula master associada ao grupo si, é a implementação definida. As referências de célula-mestre na mesma planilha não devem sobrepor-se umas às outras. Os valores possíveis para esse atributo são definidos pelo tipo de dados unsignedInt do esquema XML do W3C. |
| t (Tipo de Fórmula) | Tipo de fórmula. Os valores possíveis para esse atributo são definidos pelo tipo simples ST_CellFormulaType (§18.18.6). |
[Observação: a definição do esquema XML do W3C do modelo de conteúdo (CT_CellFormula) desse elemento está localizada em §A.2. nota final]
ISO/IEC29500: 2008.
Construtores
| Nome | Description |
|---|---|
| CellFormula() |
Inicializa uma nova instância da classe CellFormula. |
| CellFormula(String) |
Inicializa uma nova instância da classe CellFormula com o conteúdo de texto especificado. |
Propriedades
| Nome | Description |
|---|---|
| AlwaysCalculateArray |
Sempre Calcular Matriz Representa o seguinte atributo no esquema: aca |
| Bx |
Atribui valor ao nome Representa o seguinte atributo no esquema: bx |
| CalculateCell |
Calcular Célula Representa o seguinte atributo no esquema: ca |
| ChildElements |
Obtém todos os nós filhos do elemento atual. (Herdado de OpenXmlElement) |
| DataTable2D |
Tabela de Dados 2D Representa o seguinte atributo no esquema: dt2D |
| DataTableRow |
Linha da Tabela de Dados Representa o seguinte atributo no esquema: dtr |
| ExtendedAttributes |
Obtém todos os atributos estendidos (atributos não definidos no esquema) do elemento atual. (Herdado de OpenXmlElement) |
| Features |
Obtém um IFeatureCollection para o elemento atual. Essa coleção de recursos será somente leitura, mas herdará recursos de sua parte pai e pacote, se disponível. (Herdado de OpenXmlElement) |
| FirstChild |
Obtém o primeiro filho do elemento OpenXmlElement. Retorna null (Nothing no Visual Basic) se não existe esse elemento OpenXmlElement. (Herdado de OpenXmlElement) |
| FormulaType |
Tipo de fórmula Representa o seguinte atributo no esquema: t |
| HasAttributes |
Obtém um valor que indica se o elemento atual tem algum atributo. (Herdado de OpenXmlElement) |
| HasChildren |
Obtém um valor que indica se o elemento atual tem algum elemento filho. (Herdado de OpenXmlLeafTextElement) |
| InnerText |
Obtém ou define os valores concatenados do elemento e de todos os seus elementos filho. (Herdado de OpenXmlLeafTextElement) |
| InnerXml |
Obtém ou define a marcação que representa apenas elementos filho do elemento atual. (Herdado de OpenXmlLeafTextElement) |
| Input1Deleted |
Entrada 1 excluída Representa o seguinte atributo no esquema: del1 |
| Input2Deleted |
Entrada 2 excluída Representa o seguinte atributo no esquema: del2 |
| LastChild |
Obtém o último filho do elemento OpenXmlElement. Retorna null (Nothing no Visual Basic) se não existe esse elemento OpenXmlElement. (Herdado de OpenXmlElement) |
| LocalName |
Fórmula. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, seu nome qualificado é x:f. |
| LocalName |
Obtém o nome local do elemento atual. (Herdado de OpenXmlElement) |
| MCAttributes |
Obtém ou define os atributos de compatibilidade de marcação. Retorna null se nenhum atributo de compatibilidade de marcação for definido para o elemento atual. (Herdado de OpenXmlElement) |
| NamespaceDeclarations |
Obtém todas as declarações de namespace definidas no elemento atual. Retorna um enumerador vazio se não houver nenhuma declaração de namespace. (Herdado de OpenXmlElement) |
| NamespaceUri |
Obtém o URI do namespace do elemento atual. (Herdado de OpenXmlElement) |
| OpenXmlElementContext |
Obtém o OpenXmlElementContext do elemento atual. (Herdado de OpenXmlElement) |
| OuterXml |
Obtém a marcação que representa o elemento atual e todos os seus elementos filho. (Herdado de OpenXmlElement) |
| Parent |
Obtém o elemento pai do elemento atual. (Herdado de OpenXmlElement) |
| Prefix |
Obtém o prefixo do namespace do elemento atual. (Herdado de OpenXmlElement) |
| R1 |
Tabela de Dados Célula 1 Representa o seguinte atributo no esquema: r1 |
| R2 |
Célula de entrada 2 Representa o seguinte atributo no esquema: r2 |
| Reference |
Intervalo de células Representa o seguinte atributo no esquema: ref |
| SharedIndex |
Índice de Grupo Compartilhado Representa o seguinte atributo no esquema: si |
| Space |
O conteúdo contém espaços em branco significativos Representa o seguinte atributo no esquema: xml:space |
| Text |
Obtém ou define o texto do elemento atual. (Herdado de OpenXmlLeafTextElement) |
| XmlQualifiedName |
Obtém o nome qualificado do elemento atual. (Herdado de OpenXmlElement) |
| XName |
Obtém o nome qualificado do elemento atual. (Herdado de OpenXmlElement) |
Métodos
| Nome | Description |
|---|---|
| AddAnnotation(Object) |
Adiciona um objeto à lista de anotações do elemento OpenXmlElement atual. (Herdado de OpenXmlElement) |
| AddNamespaceDeclaration(String, String) |
Adiciona uma declaração de namespace ao nó atual. (Herdado de OpenXmlElement) |
| Ancestors() |
Enumera todos os ancestrais do elemento atual. (Herdado de OpenXmlElement) |
| Ancestors<T>() |
Enumera apenas os ancestrais do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement) |
| Annotation(Type) |
Obtenha o primeiro objeto de anotação do tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement) |
| Annotation<T>() |
Obtenha o primeiro objeto de anotação do tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement) |
| Annotations(Type) |
Obtém uma coleção de anotações com o tipo especificado para o elemento OpenXmlElement atual. (Herdado de OpenXmlElement) |
| Annotations<T>() |
Obtém uma coleção de anotações com o tipo especificado para o elemento OpenXmlElement atual. (Herdado de OpenXmlElement) |
| Append(IEnumerable<OpenXmlElement>) |
Acrescenta cada elemento de uma lista de elementos ao final da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement) |
| Append(OpenXmlElement[]) |
Acrescenta cada elemento de uma matriz de elementos ao final da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement) |
| AppendChild<T>(T) |
Anexa o elemento especificado ao final da lista de nós filhos do elemento atual. (Herdado de OpenXmlElement) |
| ClearAllAttributes() |
Limpa todos os atributos, incluindo atributos conhecidos e atributos estendidos. (Herdado de OpenXmlElement) |
| Clone() |
Cria uma duplicata do nó atual. (Herdado de OpenXmlElement) |
| CloneNode(Boolean) |
Cria uma duplicata desse nó. |
| Descendants() |
Enumera todos os descendentes do elemento atual. (Herdado de OpenXmlElement) |
| Descendants<T>() |
Enumere todos os descendentes do elemento atual do tipo T. (Herdado de OpenXmlElement) |
| Elements() |
Enumera todos os filhos do elemento atual. (Herdado de OpenXmlElement) |
| Elements<T>() |
Enumera apenas os filhos do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement) |
| ElementsAfter() |
Enumera todos os elementos irmãos que seguem o elemento atual e têm o mesmo pai que o elemento atual. (Herdado de OpenXmlElement) |
| ElementsBefore() |
Enumera todos os elementos irmãos que precedem o elemento atual e têm o mesmo pai que o elemento atual. (Herdado de OpenXmlElement) |
| GetAttribute(String, String) |
Obtém um atributo Open XML com o nome da marca especificado e o URI do namespace. (Herdado de OpenXmlElement) |
| GetAttributes() |
Obtém uma lista que contém uma cópia de todos os atributos. (Herdado de OpenXmlElement) |
| GetEnumerator() |
Retorna um enumerador que itera por meio da coleção filho. (Herdado de OpenXmlElement) |
| GetFirstChild<T>() |
Localiza o primeiro elemento filho no tipo T. (Herdado de OpenXmlElement) |
| InsertAfter<T>(T, OpenXmlElement) |
Insere o elemento especificado imediatamente após o elemento de referência especificado. (Herdado de OpenXmlElement) |
| InsertAfterSelf<T>(T) |
Insere o elemento especificado imediatamente após o elemento atual. (Herdado de OpenXmlElement) |
| InsertAt<T>(T, Int32) |
Insere o elemento especificado no índice especificado na lista de elementos filho do elemento atual. (Herdado de OpenXmlElement) |
| InsertBefore<T>(T, OpenXmlElement) |
Insere o elemento especificado imediatamente antes do elemento de referência especificado. (Herdado de OpenXmlElement) |
| InsertBeforeSelf<T>(T) |
Insere o elemento especificado imediatamente antes do elemento atual. (Herdado de OpenXmlElement) |
| IsAfter(OpenXmlElement) |
Determina se o elemento atual aparece após um elemento especificado na ordem do documento. (Herdado de OpenXmlElement) |
| IsBefore(OpenXmlElement) |
Determina se o elemento atual aparece antes de um elemento especificado na ordem do documento. (Herdado de OpenXmlElement) |
| LookupNamespace(String) |
Resolve o prefixo do namespace no contexto do nó atual. (Herdado de OpenXmlElement) |
| LookupPrefix(String) |
Localiza o prefixo correspondente para um URI de namespace no escopo do elemento atual. (Herdado de OpenXmlElement) |
| NextSibling() |
Obtém o elemento OpenXmlElement que segue imediatamente o elemento OpenXmlElement atual. Retorna null (Nothing no Visual Basic) se não houver nenhum próximo elemento OpenXmlElement. (Herdado de OpenXmlElement) |
| NextSibling<T>() |
Obtém o elemento OpenXmlElement com o tipo especificado que segue o elemento OpenXmlElement atual. Retorna null (Nothing no Visual Basic) se não houver próximo OpenXmlElement. (Herdado de OpenXmlElement) |
| PrependChild<T>(T) |
Insere o elemento especificado no início da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement) |
| PreviousSibling() |
Obtém o elemento OpenXmlElement que precede imediatamente o elemento OpenXmlElement atual. Retorna nulo (nada no Visual Basic ) se não houver nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement) |
| PreviousSibling<T>() |
Obtém o elemento OpenXmlElement com o tipo especificado que precede o OpenXmlElement atual. Retorna nulo (nada no Visual Basic) se não houver nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement) |
| Remove() |
Remove o elemento atual de seu pai. (Herdado de OpenXmlElement) |
| RemoveAllChildren() |
Remove todos os elementos filho do elemento atual. (Herdado de OpenXmlLeafTextElement) |
| RemoveAllChildren<T>() |
Remova todos os elementos filho do elemento atual que são do tipo T. (Herdado de OpenXmlElement) |
| RemoveAnnotations(Type) |
Remove as anotações do tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement) |
| RemoveAnnotations<T>() |
Remove as anotações com o tipo especificado do elemento OpenXmlElement atual. (Herdado de OpenXmlElement) |
| RemoveAttribute(String, String) |
Remove o atributo do elemento atual. (Herdado de OpenXmlElement) |
| RemoveChild<T>(T) |
Remove o elemento filho especificado da lista de elementos filho do elemento atual. (Herdado de OpenXmlElement) |
| RemoveNamespaceDeclaration(String) |
Remove a declaração de namespace para o prefixo especificado. Não removerá nada se não houver prefixo. (Herdado de OpenXmlElement) |
| ReplaceChild<T>(OpenXmlElement, T) |
Substitui um elemento filho por outro elemento filho na lista de elementos filho do elemento atual. (Herdado de OpenXmlElement) |
| SetAttribute(OpenXmlAttribute) |
Define um atributo para o elemento especificado. Se o atributo for conhecido, o valor do atributo será definido. Se o atributo for um atributo estendido, o 'openxmlAttribute' será adicionado à lista de atributos estendidos. (Herdado de OpenXmlElement) |
| SetAttributes(IEnumerable<OpenXmlAttribute>) |
Define vários atributos para o elemento. Se um atributo for conhecido, o valor do atributo será definido. Se um atributo for um atributo estendido, o 'openxmlAttribute' será adicionado à lista de atributos estendidos. (Herdado de OpenXmlElement) |
| WriteTo(XmlWriter) |
Salva o nó atual no XmlWriter especificado. (Herdado de OpenXmlElement) |
Implantações explícitas de interface
| Nome | Description |
|---|---|
| IEnumerable.GetEnumerator() |
Fórmula. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, seu nome qualificado é x:f. (Herdado de OpenXmlElement) |
| IEnumerable<OpenXmlElement>.GetEnumerator() |
Retorna um enumerador que itera por meio da coleção filho. (Herdado de OpenXmlElement) |