SetConstraintFormula(String,String) Method

'Declaration
 
Public Overloads Sub SetConstraintFormula( _
   ByVal constraintFormula As System.String, _
   ByVal address As System.String _
) 

public void SetConstraintFormula( 
   System.string constraintFormula,
   System.string address
)

Parameters

constraintFormula

The validation formula to use for the rule.

address

The address of the cell or region that serves as the basis for relative references, or null to use the top-left cell of the worksheet.

The way in which the cell value is compared to the constraint formula's value is determined by the ValidationOperator as well as the ValueConstraintDataValidationRule.ValidationCriteria.

Depending on the ValidationCriteria of the rule, either the cell value itself or the length of the cell value's text equivalent is compared to the constraint formula's value.

The address passed in is only needed if relative addresses are used in the the formula. When the data validation rule is applied to cells or regions, the references in the formula used by each individual cell will be shifted by the offset of the cell to the passed in address. For example, consider the formula specified is =B1 and the specified address is A1. If the data validation rule is then applied to the A5 cell, the formula is will use is =B5. However, if the references in the formula are absolute, such as =$B$1, the same formula will be applied regardless of the specified address.

address can be any valid cell or region reference on a worksheet. If a region address is specified, the top-left cell or the region is used. The cell or region specified does not need to have the data validation rule applied to it. Any reference is allowed.

The cell reference mode with which to parse address will be assumed to be A1, unless the data validation rule is applied to a worksheet which is in a workbook, in which case the Workbook.CellReferenceMode will be used.

Target Platforms: Windows 8.1, Windows 8.1, Windows 8, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

OneConstraintDataValidationRule Class
OneConstraintDataValidationRule Members
Overload List
SetConstraint(Double) Method
SetConstraint(TimeSpan) Method
SetConstraint(DateTime) Method
ValidationOperator Property
ValidationCriteria Property
GetConstraintFormula(String) Method
GetConstraintFormula(String,WorkbookFormat,CellReferenceMode,CultureInfo) Method
SetConstraintFormula(String,String,WorkbookFormat,CellReferenceMode,CultureInfo) Method