CellFormula Classe

Définition

Espace de noms:

DocumentFormat.OpenXml.Spreadsheet

Assembly:

DocumentFormat.OpenXml.dll

Paquet:

DocumentFormat.OpenXml v3.0.1

Formule.

Cette classe est disponible dans Office 2007 et versions ultérieures.

Lorsque l’objet est sérialisé au format xml, son nom qualifié est x :f.

public class CellFormula : DocumentFormat.OpenXml.OpenXmlLeafTextElement

type CellFormula = class
    inherit OpenXmlLeafTextElement

Public Class CellFormula
Inherits OpenXmlLeafTextElement

Héritage

Object

OpenXmlElement

OpenXmlLeafElement

OpenXmlLeafTextElement

CellFormula

Remarques

[ISO/IEC 29500-1 1st Edition]

f (Formule)

Formule de la cellule. L’expression de formule est contenue dans le nœud de caractère de cet élément.

[Exemple :

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

Fin de l’exemple]

Les valeurs possibles pour l’attribut t sont définies par le type simple ST_CellFormulaType et sont les suivantes :

Valeur

Description

array (Formule de tableau)

Formule matricielle. Une formule matricielle est une formule unique, appliquée sur une plage d’une ou plusieurs cellules. Une formule matricielle peut retourner plusieurs résultats à partir d’un seul calcul, les résultats couvrant les cellules dans lesquelles elle est contenue (§18.17.2.7).

dataTable (formule de table)

Table de données. Une table de données est une plage de cellules qui montre comment la modification de certaines valeurs dans une ou plusieurs formules affecte les résultats de ces formules. Une table de données fournit un raccourci pour le calcul de plusieurs versions en une seule opération et un moyen d’inclure les résultats de toutes les différentes variantes dans une feuille.

Les tables de données de variables à entrée unique et à deux entrées peuvent être créées (voir attribut dt2D). [Exemple : une table de données variable à entrée unique peut être utilisée pour calculer l’incidence des différents taux d’intérêt sur un paiement hypothécaire mensuel, tandis qu’une table de données variable à deux entrées peut être utilisée pour calculer la façon dont différents taux d’intérêt et conditions de prêt affecteront le paiement hypothécaire. Fin de l’exemple]

Dans une table de données de variable à entrée unique, les valeurs sont répertoriées en bas d’une colonne (orientée colonne) ou sur une ligne (orientée ligne) (voir attribut dtr).

Les formules utilisées dans une table de données de variable à entrée unique doivent faire référence à une cellule d’entrée (voir attribut r1), cellule dans laquelle chaque valeur d’entrée d’une table de données est remplacée. N’importe quelle cellule d’une feuille de calcul peut être la cellule d’entrée. Bien que la cellule d’entrée n’ait pas besoin de faire partie de la table de données, les formules des tableaux de données doivent faire référence à cette cellule d’entrée.

Les tables de données de variables à deux entrées utilisent une seule formule avec deux listes de valeurs d’entrée. La formule doit faire référence à deux cellules d’entrée (voir les attributs r1 et r2).

La cellule supérieure gauche de la table de données est appelée cellule master.

[Conseils : Il est recommandé que les applications de feuille de calcul recalculent les tables de données chaque fois qu’une feuille de calcul est recalculée. end guidance]

normal (formule normale)

Formule de cellule normale (§18.17).

shared (formule partagée)

Formule partagée. Si une cellule contient la même formule qu’une autre cellule, la valeur « shared » peut être utilisée pour l’attribut t et l’attribut si peut être utilisé pour faire référence à la cellule contenant la formule. Deux formules sont considérées comme identiques lorsque leurs représentations respectives en notation de référence R1C1 sont identiques.

Éléments parents
c (§18.3.1.4) ; nc (§18.11.1.3) ; oc (§18.11.1.5)

Attributs	Description
aca (Always Calculate Array)	S’applique uniquement aux formules de tableau. true indique que l’ensemble du tableau doit être calculé dans son intégralité. Si la valeur est false , les cellules individuelles du tableau doivent être calculées en fonction des besoins. La valeur aca doit être ignorée, sauf si la valeur de l’attribut t correspondant est array. [Remarque : le cas principal où une formule matricielle doit être calculée en partie plutôt qu’en totalité est lorsque certaines cellules du tableau dépendent d’autres cellules qui sont semi-calculées, par exemple, contient la fonction =(). Fin de la remarque] Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML.
bx (attribue une valeur au nom)	Spécifie que cette formule affecte une valeur à un nom. Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML.
ca (Calculate Cell)	Indique que cette formule doit être recalculée la prochaine fois que le calcul est effectué. [Exemple : Ceci est toujours défini sur les fonctions volatiles, comme =() et les références circulaires. Fin de l’exemple] Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML.
del1 (entrée 1 supprimée)	Indique si la première cellule d’entrée de la table de données a été supprimée. S’applique uniquement à la formule de table de données. Écrit sur master cellule de la formule de table de données uniquement. Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML.
del2 (entrée 2 supprimée)	Indique si la deuxième cellule d’entrée de la table de données a été supprimée. S’applique uniquement à la formule de table de données. Écrit sur master cellule de la formule de table de données uniquement. Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML.
dt2D (Table de données 2-D)	La table de données est à deux dimentionals. S’applique uniquement à la fonction de tables de données. Écrit sur master cellule de la formule de table de données uniquement. Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML.
dtr (ligne de la table de données)	true si la table de données une dimentionale est une ligne, sinon il s’agit d’une colonne. S’applique uniquement à la fonction de tables de données. Écrit sur master cellule de la formule de table de données uniquement. Les valeurs possibles de cet attribut sont définies par le type de données boolean du schéma W3C XML.
r1 (cellule de table de données 1)	Première cellule d’entrée pour la table de données. S’applique uniquement à la fonction de tableau de tables de données « TABLE() ». Écrit sur master cellule de la formule de table de données uniquement. Les valeurs possibles pour cet attribut sont définies par le type simple ST_CellRef (§18.18.7).
r2 (cellule d’entrée 2)	Deuxième cellule d’entrée pour la table de données lorsque dt2D a la valeur « 1 ». S’applique uniquement à la fonction de tableau de tables de données « TABLE() ». Écrit sur master cellule de la formule de table de données uniquement. Les valeurs possibles pour cet attribut sont définies par le type simple ST_CellRef (§18.18.7).
ref (Plage de cellules)	Plage de cellules auxquelles la formule s’applique. Requis uniquement pour la formule partagée, la formule matricielle ou la table de données. Écrit uniquement sur la formule master, et non sur les formules suivantes appartenant au même groupe partagé, tableau ou table de données. Les valeurs possibles pour cet attribut sont définies par le type simple ST_Ref (§18.18.62).
si (Index de groupe partagé)	Attribut facultatif pour optimiser les performances de chargement en partageant des formules. Lorsqu’une formule est une formule partagée (la valeur t est partagée), cette valeur indique le groupe auquel appartient la formule de cette cellule particulière. La première formule d’un groupe de formules partagées est enregistrée dans l’élément f. Il s’agit de la cellule de formule « master ». Les cellules suivantes partageant cette formule n’ont pas besoin que la formule soit écrite dans leur élément f. Au lieu de cela, la valeur de l’attribut si pour une cellule particulière est utilisée pour déterminer ce que doit être l’expression de formule en fonction de l’emplacement relatif de la cellule par rapport à la cellule de formule master. Une cellule est partagée uniquement quand si est utilisé et que t est partagé. L’expression de formule d’une cellule spécifiée pour faire partie d’une formule partagée (et qui n’est pas la master) doit être ignorée, et la formule master doit être remplacée. Si une cellule master d’une plage de formules partagée spécifie qu’une cellule particulière fait partie de la plage de formules partagées et que cette cellule particulière n’utilise pas les attributs si et t pour indiquer qu’elle est partagée, la formule de la cellule particulière doit remplacer la formule master partagée. Si cette cellule se trouve au milieu d’une plage de cellules de formule partagées, les formules antérieures et ultérieures continueront à partager la formule master, et la cellule en question ne doit pas partager la formule de la master formule de cellule. L’implémentation est définie pour le chargement et la gestion d’une cellule et d’une formule à l’aide d’un attribut si et dont la valeur t est partagée, située en dehors de la plage spécifiée dans la cellule master associée au groupe si. Les références de cellule maître sur la même feuille ne doivent pas se chevaucher. Les valeurs possibles de cet attribut sont définies par le type de données unsignedInt du schéma XML du W3C.
t (Type de formule)	Type de formule. Les valeurs possibles pour cet attribut sont définies par le type simple ST_CellFormulaType (§18.18.6).

[Remarque : La définition de schéma XML W3C du modèle de contenu (CT_CellFormula) de cet élément se trouve dans §A.2. Fin de la remarque]

ISO/IEC29500 : 2008.

Constructeurs

CellFormula()	Initialise une nouvelle instance de la classe CellFormula.
CellFormula(String)	Initialise une nouvelle instance de la classe CellFormula avec le contenu de texte spécifié.

Propriétés

AlwaysCalculateArray	Always Calculate Array Représente l’attribut suivant dans le schéma : aca
Bx	Affecte une valeur au nom Représente l’attribut suivant dans le schéma : bx
CalculateCell	Calculer la cellule Représente l’attribut suivant dans le schéma : ca
ChildElements	Obtient tous les nœuds enfants de l’élément actuel. (Hérité de OpenXmlElement)
DataTable2D	Table de données 2D Représente l’attribut suivant dans le schéma : dt2D
DataTableRow	Ligne de la table de données Représente l’attribut suivant dans le schéma : dtr
ExtendedAttributes	Obtient tous les attributs étendus (attributs non définis dans le schéma) de l’élément actuel. (Hérité de OpenXmlElement)
Features	Obtient un IFeatureCollection pour l’élément actuel. Cette collection de fonctionnalités sera en lecture seule, mais héritera des fonctionnalités de sa partie parente et de son package, le cas échéant. (Hérité de OpenXmlElement)
FirstChild	Obtient le premier enfant de l’élément OpenXmlElement. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement de ce type. (Hérité de OpenXmlElement)
FormulaType	Type de formule Représente l’attribut suivant dans le schéma : t
HasAttributes	Obtient une valeur indiquant si l’élément actuel a des attributs. (Hérité de OpenXmlElement)
HasChildren	Obtient une valeur qui indique si l’élément actuel a des éléments enfants. (Hérité de OpenXmlLeafTextElement)
InnerText	Obtient ou définit les valeurs concaténées de l’élément et de tous ses éléments enfants. (Hérité de OpenXmlLeafTextElement)
InnerXml	Obtient ou définit le balisage qui représente uniquement les éléments enfants de l’élément actuel. (Hérité de OpenXmlLeafTextElement)
Input1Deleted	Entrée 1 supprimée Représente l’attribut suivant dans le schéma : del1
Input2Deleted	Entrée 2 supprimée Représente l’attribut suivant dans le schéma : del2
LastChild	Obtient le dernier enfant de l’élément OpenXmlElement. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement de ce type. (Hérité de OpenXmlElement)
LocalName	Obtient le nom local de l’élément actuel. (Hérité de OpenXmlElement)
MCAttributes	Obtient ou définit les attributs de compatibilité du balisage. Retourne null si aucun attribut de compatibilité de balisage n’est défini pour l’élément actuel. (Hérité de OpenXmlElement)
NamespaceDeclarations	Obtient toutes les déclarations d’espace de noms définies dans l’élément actuel. Retourne un énumérateur vide s’il n’y a pas de déclaration d’espace de noms. (Hérité de OpenXmlElement)
NamespaceUri	Obtient l’URI d’espace de noms de l’élément actuel. (Hérité de OpenXmlElement)
OpenXmlElementContext	Obtient l’élément OpenXmlElementContext de l’élément actuel. (Hérité de OpenXmlElement)
OuterXml	Obtient le balisage qui représente l’élément actuel et tous ses éléments enfants. (Hérité de OpenXmlElement)
Parent	Obtient l’élément parent de l’élément actuel. (Hérité de OpenXmlElement)
Prefix	Obtient le préfixe d’espace de noms de l’élément actuel. (Hérité de OpenXmlElement)
R1	Cellule 1 de la table de données Représente l’attribut suivant dans le schéma : r1
R2	Cellule d’entrée 2 Représente l’attribut suivant dans le schéma : r2
Reference	Plage de cellules Représente l’attribut suivant dans le schéma : ref
SharedIndex	Index de groupe partagé Représente l’attribut suivant dans le schéma : si
Space	Le contenu contient des espaces blancs significatifs Représente l’attribut suivant dans le schéma : xml :space
Text	Obtient ou définit le texte de l’élément actuel. (Hérité de OpenXmlLeafTextElement)
XmlQualifiedName	Obtient le nom qualifié de l’élément actuel. (Hérité de OpenXmlElement)
XName	Obtient le nom qualifié de l’élément actuel. (Hérité de OpenXmlElement)

Méthodes

AddAnnotation(Object)	Ajoute un objet à la liste d’annotations de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
AddNamespaceDeclaration(String, String)	Ajoute une déclaration d’espace de noms au nœud actuel. (Hérité de OpenXmlElement)
Ancestors()	Énumère tous les ancêtres de l’élément actuel. (Hérité de OpenXmlElement)
Ancestors<T>()	Énumère uniquement les ancêtres de l’élément actuel qui ont le type spécifié. (Hérité de OpenXmlElement)
Annotation(Type)	Obtenez le premier objet d’annotation du type spécifié à partir de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Annotation<T>()	Obtenez le premier objet d’annotation du type spécifié à partir de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Annotations(Type)	Obtient une collection d’annotations avec le type spécifié pour l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Annotations<T>()	Obtient une collection d’annotations avec le type spécifié pour l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
Append(IEnumerable<OpenXmlElement>)	Ajoute chaque élément d’une liste d’éléments à la fin de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
Append(OpenXmlElement[])	Ajoute chaque élément d’un tableau d’éléments à la fin de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
AppendChild<T>(T)	Ajoute l’élément spécifié à la fin de la liste des nœuds enfants de l’élément actuel. (Hérité de OpenXmlElement)
ClearAllAttributes()	Efface tous les attributs, y compris les attributs connus et les attributs étendus. (Hérité de OpenXmlElement)
Clone()	Crée un doublon du nœud actuel. (Hérité de OpenXmlElement)
CloneNode(Boolean)	Crée un doublon de ce nœud.
Descendants()	Énumère tous les descendants de l’élément actuel. (Hérité de OpenXmlElement)
Descendants<T>()	Énumérez tous les descendants de l’élément actuel de type T. (Hérité de OpenXmlElement)
Elements()	Énumère tous les enfants de l’élément actuel. (Hérité de OpenXmlElement)
Elements<T>()	Énumère uniquement les enfants de l’élément actuel qui ont le type spécifié. (Hérité de OpenXmlElement)
ElementsAfter()	Énumère tous les éléments frères qui suivent l’élément actuel et ont le même parent que l’élément actuel. (Hérité de OpenXmlElement)
ElementsBefore()	Énumère tous les éléments frères qui précèdent l’élément actuel et ont le même parent que l’élément actuel. (Hérité de OpenXmlElement)
GetAttribute(String, String)	Obtient un attribut Open XML avec le nom de balise et l’URI d’espace de noms spécifiés. (Hérité de OpenXmlElement)
GetAttributes()	Obtient une liste qui contient une copie de tous les attributs. (Hérité de OpenXmlElement)
GetEnumerator()	Retourne un énumérateur qui itère au sein de la collection enfant. (Hérité de OpenXmlElement)
GetFirstChild<T>()	Recherche le premier élément enfant de type T. (Hérité de OpenXmlElement)
InsertAfter<T>(T, OpenXmlElement)	Insère l’élément spécifié immédiatement après l’élément de référence spécifié. (Hérité de OpenXmlElement)
InsertAfterSelf<T>(T)	Insère l’élément spécifié immédiatement après l’élément actuel. (Hérité de OpenXmlElement)
InsertAt<T>(T, Int32)	Insère l’élément spécifié à l’index spécifié dans la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
InsertBefore<T>(T, OpenXmlElement)	Insère l’élément spécifié juste avant l’élément de référence spécifié. (Hérité de OpenXmlElement)
InsertBeforeSelf<T>(T)	Insère l’élément spécifié juste avant l’élément actuel. (Hérité de OpenXmlElement)
IsAfter(OpenXmlElement)	Détermine si l’élément actuel apparaît après un élément spécifié dans l’ordre du document. (Hérité de OpenXmlElement)
IsBefore(OpenXmlElement)	Détermine si l’élément actuel apparaît avant un élément spécifié dans l’ordre du document. (Hérité de OpenXmlElement)
LookupNamespace(String)	Résout le préfixe d’espace de noms dans le contexte du nœud actuel. (Hérité de OpenXmlElement)
LookupPrefix(String)	Recherche le préfixe correspondant pour un URI d’espace de noms dans l’étendue de l’élément actuel. (Hérité de OpenXmlElement)
NextSibling()	Obtient l’élément OpenXmlElement qui suit immédiatement l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement suivant. (Hérité de OpenXmlElement)
NextSibling<T>()	Obtient l’élément OpenXmlElement avec le type spécifié qui suit l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’y a pas d’élément OpenXmlElement suivant. (Hérité de OpenXmlElement)
PrependChild<T>(T)	Insère l’élément spécifié au début de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
PreviousSibling()	Obtient l’élément OpenXmlElement qui précède immédiatement l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic ) s’il n’existe aucun élément OpenXmlElement précédent. (Hérité de OpenXmlElement)
PreviousSibling<T>()	Obtient l’élément OpenXmlElement avec le type spécifié qui précède l’élément OpenXmlElement actuel. Retourne null (Nothing en Visual Basic) s’il n’existe aucun élément OpenXmlElement précédent. (Hérité de OpenXmlElement)
Remove()	Supprime l’élément actuel de son parent. (Hérité de OpenXmlElement)
RemoveAllChildren()	Supprime tous les éléments enfants de l’élément actuel. (Hérité de OpenXmlLeafTextElement)
RemoveAllChildren<T>()	Supprimez tous les éléments enfants de l’élément actuel qui sont de type T. (Hérité de OpenXmlElement)
RemoveAnnotations(Type)	Supprime les annotations du type spécifié de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
RemoveAnnotations<T>()	Supprime les annotations avec le type spécifié de l’élément OpenXmlElement actuel. (Hérité de OpenXmlElement)
RemoveAttribute(String, String)	Supprime l’attribut de l’élément actuel. (Hérité de OpenXmlElement)
RemoveChild<T>(T)	Supprime l’élément enfant spécifié de la liste des éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
RemoveNamespaceDeclaration(String)	Supprime la déclaration d’espace de noms pour le préfixe spécifié. Ne supprime rien s’il n’y a pas de préfixe. (Hérité de OpenXmlElement)
ReplaceChild<T>(OpenXmlElement, T)	Remplace un élément enfant par un autre élément enfant dans la liste d’éléments enfants de l’élément actuel. (Hérité de OpenXmlElement)
SetAttribute(OpenXmlAttribute)	Définit un attribut sur l’élément spécifié. Si l’attribut est un attribut connu, la valeur de l’attribut est définie. Si l’attribut est un attribut étendu, l’attribut « openxmlAttribute » est ajouté à la liste des attributs étendus. (Hérité de OpenXmlElement)
SetAttributes(IEnumerable<OpenXmlAttribute>)	Définit un certain nombre d’attributs à l’élément . Si un attribut est un attribut connu, la valeur de l’attribut est définie. Si un attribut est un attribut étendu, l’attribut « openxmlAttribute » est ajouté à la liste des attributs étendus. (Hérité de OpenXmlElement)
WriteTo(XmlWriter)	Enregistre le nœud actuel dans le XmlWriter spécifié. (Hérité de OpenXmlElement)

Implémentations d’interfaces explicites

IEnumerable.GetEnumerator()	Formule. Cette classe est disponible dans Office 2007 et versions ultérieures. Lorsque l’objet est sérialisé au format xml, son nom qualifié est x :f. (Hérité de OpenXmlElement)
IEnumerable<OpenXmlElement>.GetEnumerator()	Retourne un énumérateur qui itère au sein de la collection enfant. (Hérité de OpenXmlElement)