SetColumnFormula(Formula,Boolean) メソッド

この列のデータ セルで使用する数式を設定します。

シンタックス

C#

public void SetColumnFormula( 
   Formula formula,
   bool overwriteExistingValues
)

パラメータ

formula

この列のデータ セルで使用したい数式を指定します。null 値を指定すると、現在の列に設定されている数式が削除されます。

overwriteExistingValues

既存のセル値を上書きして、この列の全データ セルに数式を適用したい場合は true に設定します。値が設定されていないセルにのみ数式を適用したい場合は False に設定します。

例外

例外	解説
System.ArgumentException	列がテーブルから削除された場合。formula は、セルやテーブル列といった他の領域にすでに適用されています。
System.InvalidOperationException	列がテーブルから削除された場合。

解説

指定した数式に相対セル参照や相対領域参照が含まれている場合、実際の数式は列にある最初のデータ セルに適用するものとみなされます。この数式が列内の他のセルに適用される場合、相対参照値が適切な量だけずらされます。

列の数式を設定し、テーブルのサイズを変更して列の数を増やした場合、その列内の新しいセルには、その列の数式が適用されることになります。

以前に適用された別の列数式があって、列内のいずれかのセルにその数式が適用されている場合、その数式を別の数式に変更すると、セルに適用されていた以前の数式は、overwriteExistingValues の値に関係なく上書きされることになります。