GetConstraintFormula(String,WorkbookFormat,CellReferenceMode,CultureInfo) メソッド

セル値を検証するために使用する制約数式を取得します。

シンタックス

C#

public string GetConstraintFormula( 
   string address,
   WorkbookFormat format,
   CellReferenceMode cellReferenceMode,
   CultureInfo culture
)

パラメータ

address

相対参照の基準となるセルまたは領域のアドレスか、ワークシートの左上のセルを使用する場合は null。

format

address を解析するために使用するブック形式。

cellReferenceMode

address を解析するために使用するセル参照モード。

culture

数式文字列を生成するときに使用するカルチャ。

戻り値の型

セルに適用される値を検証するために使用する数式。

例外

例外	解説
System.ArgumentException	address が有効なセル アドレスまたは領域アドレスでない場合に発生します。
System.ComponentModel.InvalidEnumArgumentException	format が WorkbookFormat 列挙体で定義されていない場合に発生します。
System.ComponentModel.InvalidEnumArgumentException	cellReferenceMode が CellReferenceMode 列挙体で定義されていない場合に発生します。

解説

セル値を制約数式の値と比較する方法は、ValidationOperator および ValueConstraintDataValidationRule.ValidationCriteria で決定されます。

ルールの ValidationCriteria に応じて、セル値自体またはセル値に相当するテキストの長さが制約数式の値と比較されます。

渡されたアドレスは、数式中で相対アドレスを使用する場合にのみ必要です。たとえば、適用された数式が =B1 で、データの入力規則ルールが領域 A1:A5 に適用されるとします。A1 の数式を取得すると、数式 =B1 が返されます。A2 の数式を取得すると、=B2 が返されます。同様に、セル A5 では =B5 が返されます。ただし、数式に参照が含まれていないかすべてが絶対参照の場合、address は無視されます。そのため、上の例で、元の数式が =$B$1 の場合、指定したアドレスにかかわらず同じ数式が返されます。

address は、ワークシート上の任意の有効なセルまたは領域参照です。領域アドレスが指定された場合、左上のセルまたは領域が使用されます。指定されたセルまたは領域には、データの入力規則ルールが適用されている必要はありません。すべての参照が許可されます。