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, o 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 caráter deste elemento.
[Exemplo:
<f>
SUM(C4:E4)</f>
exemplo final]
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 única fórmula, aplicada num intervalo de uma ou mais células. Uma fórmula de matriz pode devolver múltiplos resultados de um único cálculo, os resultados que abrangem as células em que 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 determinados valores numa ou mais fórmulas afeta os resultados dessas fórmulas. Uma tabela de dados fornece um atalho para calcular várias versões numa operação e uma forma de incluir os resultados de todas as diferentes variações numa folha.
Podem ser criadas tabelas de dados de variáveis de entrada única e duas (veja atributo dt2D). [Exemplo: Uma tabela de dados variável de entrada única pode ser utilizada para calcular como diferentes taxas de juro afetam um pagamento mensal de hipoteca, enquanto uma tabela de dados variável de dois entradas pode ser utilizada para calcular como diferentes taxas de juro e termos de empréstimo afetarão o pagamento da hipoteca. exemplo final]
Numa tabela de dados de variável de entrada única, os valores são listados numa coluna (orientada para colunas) ou numa linha (orientada para linhas) (ver atributo dtr).
As fórmulas utilizadas numa tabela de dados de uma variável de entrada devem referir-se a uma célula de entrada (ver atributo r1), a célula na qual cada valor de entrada de uma tabela de dados é substituído. Qualquer célula numa folha de cálculo pode ser a célula de entrada. Embora a célula de entrada não precise de fazer parte da tabela de dados, as fórmulas nas tabelas de dados devem referir-se a essa célula de entrada.
As tabelas de dados de variáveis de duas entradas utilizam 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 é denominada célula master.
[Orientação: recomenda-se que as aplicações de Folha de Cálculo recalculem tabelas de dados sempre que uma folha de cálculo for recalculada. end guidance]
normal (fórmula normal)
Fórmula de célula normal (}18.17).
partilhado (fórmula partilhada)
Fórmula partilhada. Se uma célula contiver a mesma fórmula que outra célula, o valor "partilhado" pode ser utilizado para o atributo t e o atributo si pode ser utilizado para fazer referência à célula que contém a fórmula. Duas fórmulas são consideradas iguais quando as respetivas representações na notação R1C1-reference 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 (Calcular Sempre Matriz) | Aplica-se apenas a fórmulas de matriz.
true indica que toda a matriz deve ser calculada na totalidade. Se forem falsas , as células individuais da matriz serão calculadas conforme necessário. O valor aca deve ser ignorado, a menos que o valor do atributo t correspondente seja matriz. [Nota: o caso principal em que uma fórmula de matriz tem de ser calculada em parte em vez de na totalidade é quando algumas células na matriz dependem de outras células semi-calculadas, por exemplo, contém a função =(). nota de fim] Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C. |
| bx (Atribui Valor ao Nome) | Especifica que esta fórmula atribui um valor a um nome. Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C. |
| ca (Calcular Célula) | Indica que esta fórmula tem de ser recalculada da próxima vez que o cálculo for efetuado. [Exemplo: isto é sempre definido em funções voláteis, como =() e referências circulares.
exemplo final] Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C. |
| del1 (Entrada 1 Eliminada) | Se a primeira célula de entrada da tabela de dados foi eliminada. Aplica-se apenas à fórmula da tabela de dados. Escrito apenas master célula da fórmula da tabela de dados. Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C. |
| del2 (Entrada 2 Eliminada) | Se a segunda célula de entrada da tabela de dados foi eliminada. Aplica-se apenas à fórmula da tabela de dados. Escrito apenas master célula da fórmula da tabela de dados. Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C. |
| dt2D (Tabela de Dados 2D) | A tabela de dados é bidirecional. Aplica-se apenas à função de tabelas de dados. Escrito apenas master célula da fórmula da tabela de dados. Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C. |
| dtr (Linha da Tabela de Dados) |
true se uma tabela de dados dimentional for uma linha, caso contrário, é uma coluna. Aplica-se apenas à função de tabelas de dados. Escrito apenas master célula da fórmula da tabela de dados. Os valores possíveis para este atributo são definidos pelo tipo de dados booleano de esquema XML W3C. |
| r1 (Célula 1 da Tabela de Dados) | Primeira célula de entrada para a tabela de dados. Aplica-se apenas à função de matriz de tabelas de dados "TABLE()". Escrito apenas master célula da fórmula da tabela de dados. Os valores possíveis para este atributo são definidos pelo ST_CellRef tipo simples (}18.18.7). |
| r2 (Célula de Entrada 2) | Segunda célula de entrada para a tabela de dados quando dt2D é "1". Aplica-se apenas à função de matriz de tabelas de dados "TABLE()". Escrito apenas master célula da fórmula da tabela de dados. Os valores possíveis para este atributo são definidos pelo ST_CellRef tipo simples (}18.18.7). |
| ref (Intervalo de Células) | Intervalo de células a que a fórmula se aplica. Só é necessário para fórmulas partilhadas, fórmulas de matriz ou tabelas de dados. Escrito apenas na fórmula master, não em fórmulas subsequentes pertencentes ao mesmo grupo partilhado, matriz ou tabela de dados. Os valores possíveis para este atributo são definidos pelo ST_Ref tipo simples (}18.18.62). |
| si (Índice de Grupo Partilhado) | Atributo opcional para otimizar o desempenho de carga ao partilhar fórmulas. Quando uma fórmula é uma fórmula partilhada (o valor t é partilhado), este valor indica o grupo ao qual pertence a fórmula desta célula específica. A primeira fórmula num grupo de fórmulas partilhadas é guardada no elemento f. Esta é considerada a célula da fórmula "master". As células subsequentes que partilham esta fórmula não precisam de ter a fórmula escrita no elemento f. Em vez disso, o valor si do atributo de uma determinada célula é utilizado para calcular o que a expressão de fórmula deve basear-se na localização relativa da célula para a célula da fórmula master. Uma célula só é partilhada quando o si é utilizado e o t é partilhado. A expressão de fórmula de uma célula especificada para fazer parte de uma fórmula partilhada (e não é o master) deve ser ignorada e a fórmula master deve ser substituída. Se uma célula master de um intervalo de fórmulas partilhada especificar que uma determinada célula faz parte do intervalo de fórmulas partilhadas e essa célula específica não utilizar os atributos si e t para indicar que é partilhada, a fórmula da célula específica substituirá a fórmula de master partilhada. Se esta célula ocorrer no meio de um intervalo de células de fórmulas partilhadas, as fórmulas anteriores e posteriores continuarão a partilhar a fórmula master e a célula em questão não partilhará a fórmula da fórmula da célula master. O carregamento e o processamento de uma célula e fórmula com um atributo si e cujo valor t é partilhado, localizado fora do intervalo especificado no master célula associada ao grupo si, é definido pela implementação. As referências de células mestras na mesma folha não se sobrepõem entre si. Os valores possíveis para este atributo são definidos pelo tipo de dados W3C XML Schema unsignedInt . |
| t (Tipo de Fórmula) | Tipo de fórmula. Os valores possíveis para este atributo são definidos pelo ST_CellFormulaType tipo simples (}18.18.6). |
[Nota: a definição de Esquema XML W3C do modelo de conteúdo deste elemento (CT_CellFormula) está localizada em {A.2. nota de fim]
ISO/IEC29500: 2008.
Construtores
| 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
| AlwaysCalculateArray |
Calcular Sempre Matriz Representa o seguinte atributo no esquema: aca |
| Bx |
Atribui Valor a 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 subordinados 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 expandidos (atributos não definidos no esquema) do elemento atual. (Herdado de OpenXmlElement) |
| Features |
Obtém um IFeatureCollection para o elemento atual. Esta coleção de funcionalidades será só de leitura, mas herdará as funcionalidades da parte principal e do pacote, se disponível. (Herdado de OpenXmlElement) |
| FirstChild |
Obtém o primeiro elemento subordinado do elemento OpenXmlElement. Devolve nulo (Nada no Visual Basic) se não existir 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 atributos. (Herdado de OpenXmlElement) |
| HasChildren |
Obtém um valor que indica se o elemento atual tem elementos subordinados. (Herdado de OpenXmlLeafTextElement) |
| InnerText |
Obtém ou define os valores concatenados do elemento e todos os respetivos elementos subordinados. (Herdado de OpenXmlLeafTextElement) |
| InnerXml |
Obtém ou define a marcação que representa apenas elementos subordinados do elemento atual. (Herdado de OpenXmlLeafTextElement) |
| Input1Deleted |
Entrada 1 Eliminada Representa o seguinte atributo no esquema: del1 |
| Input2Deleted |
Entrada 2 Eliminada Representa o seguinte atributo no esquema: del2 |
| LastChild |
Obtém o último elemento subordinado do elemento OpenXmlElement. Devolve nulo (Nada no Visual Basic) se não existir 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, o 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 markup. Devolve nulo se não forem definidos atributos de compatibilidade de markup para o elemento atual. (Herdado de OpenXmlElement) |
| NamespaceDeclarations |
Obtém todas as declarações de espaço de nomes definidas no elemento atual. Devolve um enumerador vazio se não existir nenhuma declaração de espaço de nomes. (Herdado de OpenXmlElement) |
| NamespaceUri |
Obtém o URI do espaço de nomes 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 respetivos elementos subordinados. (Herdado de OpenXmlElement) |
| Parent |
Obtém o elemento principal do elemento atual. (Herdado de OpenXmlElement) |
| Prefix |
Obtém o prefixo de espaço de nomes do elemento atual. (Herdado de OpenXmlElement) |
| R1 |
Célula 1 da Tabela de Dados 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 Partilhado Representa o seguinte atributo no esquema: si |
| Space |
Conteúdo Contém Espaço em Branco Significativo 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
| AddAnnotation(Object) |
Adiciona um objeto à lista de anotações do elemento OpenXmlElement atual. (Herdado de OpenXmlElement) |
| AddNamespaceDeclaration(String, String) |
Adiciona uma declaração de espaço de nomes ao nó atual. (Herdado de OpenXmlElement) |
| Ancestors() |
Enumera todos os predecessores do elemento atual. (Herdado de OpenXmlElement) |
| Ancestors<T>() |
Enumera apenas os predecessores do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement) |
| Annotation(Type) |
Obtenha o primeiro objeto de anotação do tipo especificado a partir do elemento OpenXmlElement atual. (Herdado de OpenXmlElement) |
| Annotation<T>() |
Obtenha o primeiro objeto de anotação do tipo especificado a partir 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 fim da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement) |
| Append(OpenXmlElement[]) |
Acrescenta cada elemento de uma matriz de elementos ao fim da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement) |
| AppendChild<T>(T) |
Acrescenta o elemento especificado ao fim da lista de nós subordinados do elemento atual. (Herdado de OpenXmlElement) |
| ClearAllAttributes() |
Limpa todos os atributos, incluindo atributos conhecidos e atributos expandidos. (Herdado de OpenXmlElement) |
| Clone() |
Cria um duplicado do nó atual. (Herdado de OpenXmlElement) |
| CloneNode(Boolean) |
Cria um duplicado deste nó. |
| Descendants() |
Enumera todos os descendentes do elemento atual. (Herdado de OpenXmlElement) |
| Descendants<T>() |
Enumerar todos os descendentes do elemento atual do tipo T. (Herdado de OpenXmlElement) |
| Elements() |
Enumera todos os elementos subordinados do elemento atual. (Herdado de OpenXmlElement) |
| Elements<T>() |
Enumera apenas os subordinados do elemento atual que têm o tipo especificado. (Herdado de OpenXmlElement) |
| ElementsAfter() |
Enumera todos os elementos do elemento colateral que seguem o elemento atual e têm o mesmo elemento principal que o elemento atual. (Herdado de OpenXmlElement) |
| ElementsBefore() |
Enumera todos os elementos do elemento colateral que precedem o elemento atual e têm o mesmo elemento principal que o elemento atual. (Herdado de OpenXmlElement) |
| GetAttribute(String, String) |
Obtém um atributo Open XML com o nome da etiqueta especificado e o URI do espaço de nomes. (Herdado de OpenXmlElement) |
| GetAttributes() |
Obtém uma lista que contém uma cópia de todos os atributos. (Herdado de OpenXmlElement) |
| GetEnumerator() |
Devolve um enumerador que itera através da coleção subordinada. (Herdado de OpenXmlElement) |
| GetFirstChild<T>() |
Localiza o primeiro elemento subordinado 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 subordinados 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 depois de 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 espaço de nomes no contexto do nó atual. (Herdado de OpenXmlElement) |
| LookupPrefix(String) |
Localiza o prefixo correspondente para um URI de espaço de nomes no âmbito do elemento atual. (Herdado de OpenXmlElement) |
| NextSibling() |
Obtém o elemento OpenXmlElement que segue imediatamente o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement seguinte. (Herdado de OpenXmlElement) |
| NextSibling<T>() |
Obtém o elemento OpenXmlElement com o tipo especificado que segue o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir um OpenXmlElement seguinte. (Herdado de OpenXmlElement) |
| PrependChild<T>(T) |
Insere o elemento especificado no início da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement) |
| PreviousSibling() |
Obtém o elemento OpenXmlElement que precede imediatamente o elemento OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement) |
| PreviousSibling<T>() |
Obtém o elemento OpenXmlElement com o tipo especificado que precede o OpenXmlElement atual. Devolve nulo (Nada no Visual Basic) se não existir nenhum elemento OpenXmlElement anterior. (Herdado de OpenXmlElement) |
| Remove() |
Remove o elemento atual do respetivo elemento principal. (Herdado de OpenXmlElement) |
| RemoveAllChildren() |
Remove todos os elementos subordinados do elemento atual. (Herdado de OpenXmlLeafTextElement) |
| RemoveAllChildren<T>() |
Remova todos os elementos subordinados 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 subordinado especificado da lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement) |
| RemoveNamespaceDeclaration(String) |
Remove a declaração de espaço de nomes para o prefixo especificado. Não remove nada se não existir um prefixo. (Herdado de OpenXmlElement) |
| ReplaceChild<T>(OpenXmlElement, T) |
Substitui um elemento subordinado por outro elemento subordinado na lista de elementos subordinados do elemento atual. (Herdado de OpenXmlElement) |
| SetAttribute(OpenXmlAttribute) |
Define um atributo para o elemento especificado. Se o atributo for um atributo conhecido, o valor do atributo é definido. Se o atributo for um atributo expandido, o "openxmlAttribute" é adicionado à lista de atributos expandidos. (Herdado de OpenXmlElement) |
| SetAttributes(IEnumerable<OpenXmlAttribute>) |
Define vários atributos para o elemento . Se um atributo for um atributo conhecido, o valor do atributo é definido. Se um atributo for um atributo expandido, o "openxmlAttribute" é adicionado à lista de atributos expandidos. (Herdado de OpenXmlElement) |
| WriteTo(XmlWriter) |
Guarda o nó atual no XmlWriter especificado. (Herdado de OpenXmlElement) |
Implantações explícitas de interface
| IEnumerable.GetEnumerator() |
Fórmula. Esta classe está disponível no Office 2007 e superior. Quando o objeto é serializado como xml, o nome qualificado é x:f. (Herdado de OpenXmlElement) |
| IEnumerable<OpenXmlElement>.GetEnumerator() |
Devolve um enumerador que itera através da coleção subordinada. (Herdado de OpenXmlElement) |