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 1st Edition]

f (数式)

セルの数式。 式は、この要素の文字ノードに含まれています。

[例:

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

例終わり]

t 属性に使用できる値は、単純な型 ST_CellFormulaTypeによって定義され、次のようになります。

値

説明

array (配列の数式)

配列の数式。 配列数式は、1 つ以上のセルの範囲に適用される 1 つの数式です。 配列数式は、1 つの計算から複数の結果を返すことができます。その結果は、含まれているセルにまたがる結果です (§18.17.2.7)。

dataTable (テーブル数式)

データ テーブル データ テーブルは、1 つ以上の数式の特定の値を変更すると、それらの数式の結果にどのように影響するかを示すセルの範囲です。 データ テーブルには、1 回の操作で複数のバージョンを計算するためのショートカットと、シート内のすべての異なるバリエーションの結果を含める方法が用意されています。

1 入力と 2 入力の両方の変数データ テーブルを作成できます (属性 dt2D を参照)。[例: 1 つの入力変数データ テーブルを使用して、異なる金利が毎月の住宅ローン支払に与える影響を計算し、2 入力変数データ テーブルを使用して、異なる金利とローン条件が住宅ローン支払に与える影響を計算できます。 例終わり]

1 入力変数データ テーブルでは、値が列 (列指向) または行全体 (行指向) のいずれかに一覧表示されます (属性 dtr を参照)。

1 入力変数データ テーブルで使用される数式は、入力セル (属性 r1 を参照) を参照します。このセルは、データ テーブルの各入力値が置き換えられます。 ワークシート上の任意のセルを入力セルにすることができます。 入力セルをデータ テーブルの一部にする必要はありませんが、データ テーブル内の数式は、その入力セルを参照する必要があります。

2 入力変数データ テーブルでは、入力値のリストが 2 つある数式が 1 つだけ使用されます。 数式は、2 つの入力セルを参照する必要があります (属性 r1 と r2 を参照)。

データ テーブルの左上のセルは、 マスター セルと呼ばれます。

[ガイダンス: ワークシートが再計算されるたびに、スプレッドシート アプリケーションでデータ テーブルを再計算することをお勧めします。 end guidance]

normal (標準の数式)

標準セル式 (§18.17)。

shared (共有式)

共有数式。 セルに別のセルと同じ数式が含まれている場合は、t 属性に "shared" 値を使用し、si 属性を使用して数式を含むセルを参照できます。 R1C1-reference 表記のそれぞれの表現が同じ場合、2 つの数式は同じであると見なされます。

親の要素
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 削除済み)	データ テーブルの 2 番目の入力セルが削除されたかどうか。 データ テーブルの数式にのみ適用されます。 データ テーブル数式のマスター セルにのみ書き込まれます。 この属性で使用できる値は、W3C XML スキーマの boolean データ型で定義されています。
dt2D (データ テーブル 2-D)	データ テーブルは 2 次元です。 データ テーブル関数にのみ適用されます。 データ テーブル数式のマスター セルにのみ書き込まれます。 この属性で使用できる値は、W3C XML スキーマの boolean データ型で定義されています。
dtr (データ テーブル行)	1 次元データ テーブルが行の場合は true、それ以外の場合は列です。 データ テーブル関数にのみ適用されます。 データ テーブル数式のマスター セルにのみ書き込まれます。 この属性で使用できる値は、W3C XML スキーマの boolean データ型で定義されています。
r1 (データ テーブル セル 1)	データ テーブルの最初の入力セル。 データ テーブル配列関数 "TABLE()" にのみ適用されます。 データ テーブル数式のマスター セルにのみ書き込まれます。 この属性に使用できる値は、 ST_CellRef 単純型 (§18.18.7) によって定義されます。
r2 (入力セル 2)	dt2D が '1' の場合のデータ テーブルの 2 番目の入力セル。 データ テーブル配列関数 "TABLE()" にのみ適用されます。データ テーブル数式のマスター セルにのみ書き込まれます。 この属性に使用できる値は、 ST_CellRef 単純型 (§18.18.7) によって定義されます。
ref (セル範囲)	数式が適用されるセルの範囲。 共有数式、配列数式、またはデータ テーブルにのみ必要です。 マスター数式にのみ書き込まれ、同じ共有グループ、配列、またはデータ テーブルに属する後続の数式は書き込まれません。 この属性に使用できる値は、 ST_Ref 単純型 (§18.18.62) によって定義されます。
si (共有グループインデックス)	数式を共有して読み込みパフォーマンスを最適化する省略可能な属性。 数式が共有数式である場合 (t 値は 共有されます)、この値は、この特定のセルの数式が属するグループを示します。 共有数式のグループ内の最初の数式は、f 要素に保存されます。 これは、'master' 数式セルと見なされます。 この数式を共有する後続のセルには、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	常に配列を計算する スキーマ内の次の属性を表します。
Bx	値を名前に割り当てます スキーマ内の次の属性を表します: bx
CalculateCell	セルの計算 スキーマ内の次の属性を表します。
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)