Validate Element

WiX Toolset

Validate Element

Description
Sets information in the patch transform that determines if the transform applies to an installed product and what errors should be ignored when applying the patch transform.
Windows Installer references
None
Parents
PatchBaseline
Inner Text
None
Children
None
Attributes
Name Type Description Required
IgnoreAddExistingRow YesNoType Ignore errors when adding existing rows. The default is 'yes'.  
IgnoreAddExistingTable YesNoType Ignore errors when adding existing tables. The default is 'yes'.  
IgnoreChangingCodePage YesNoType Ignore errors when changing the database code page. The default is 'no'.  
IgnoreDeleteMissingRow YesNoType Ignore errors when deleting missing rows. The default is 'yes'.  
IgnoreDeleteMissingTable YesNoType Ignore errors when deleting missing tables. The default is 'yes'.  
IgnoreUpdateMissingRow YesNoType Ignore errors when updating missing rows. The default is 'yes'.  
ProductId YesNoType Requires that the installed ProductCode match the target ProductCode used to create the transform. The default is 'yes'.  
ProductLanguage YesNoType Requires that the installed ProductLanguage match the target ProductLanguage used to create the transform. The default is 'no'.  
ProductVersion Enumeration Determines how many fields of the installed ProductVersion to compare. See remarks for more information. The default is 'Update'. This attribute's value must be one of the following:
Major
Checks the major version.
Minor
Checks the major and minor versions.
Update
Checks the major, minor, and update versions.
 
ProductVersionOperator Enumeration Determines how the installed ProductVersion is compared to the target ProductVersion used to create the transform. See remarks for more information. The default is 'Equal'. This attribute's value must be one of the following:
Lesser
Installed ProductVersion < target ProductVersion.
LesserOrEqual
Installed ProductVersion <= target ProductVersion.
Equal
Installed ProductVersion = target ProductVersion.
GreaterOrEqual
Installed ProductVersion >= target ProductVersion.
Greater
Installed ProductVersion > target ProductVersion.
 
UpgradeCode YesNoType Requires that the installed UpgradeCode match the target UpgradeCode used to create the transform. The default is 'yes'.  
Remarks

A transform contains the differences between the target product and the upgraded product. When a transform or a patch (which contains transforms) is applied, the following properties of the installed product are validated against the properties of the target product stored in a transform.

  • ProductCode
  • ProductLanguage
  • ProductVersion
  • UpgradeCode

Windows Installer simply validates that the ProductCode, ProductLanguage, and UpgradeCode of an installed product are equivalent to those propeties of the target product used to create the transform; however, the ProductVersion can be validated with a greater range of comparisons.

You can compare up to the first three fields of the ProductVersion. Changes to the fourth field are not validated and are useful for small updates. You can also choose how to compare the target ProductVersion used to create the transform with the installed ProductVersion. For example, while the default value of 'Equals' is recommended, if you wanted a minor upgrade patch to apply to the target ProductVersion and all older products with the same ProductCode, you would use 'LesserOrEqual'.

See Also
Wix Schema