SetDirectory Element

WiX Toolset

SetDirectory Element

Description

Sets a Directory to a particular value. This is accomplished by creating a Type 51 custom action that is appropriately scheduled in the InstallUISequence and InstallExecuteSequence.

Windows Installer references

CustomAction Table

Parents

Fragment, Module, Product

Inner Text (xs:string)

The condition that determines whether the Directory is set. If the condition evaluates to false, the SetDirectory is skipped.

Children

None

Attributes

Name	Type	Description
Action	String	By default the action is "Set" + Id attribute's value. This optional attribute can override the action name in the case where multiple SetDirectory elements target the same Id (probably with mutually exclusive conditions).
Id	String	This attribute specifies a reference to a Directory element with matching Id attribute. The path of the Directory will be set to the Value attribute.
Sequence	SequenceType	Controls which sequences the Directory assignment is sequenced in. For 'execute', the assignment is scheduled in the InstallExecuteSequence. For 'ui', the assignment is scheduled in the InstallUISequence. For 'first', the assignment is scheduled in the InstallUISequence or the InstallExecuteSequence if the InstallUISequence is skipped at install time. For 'both', the assignment is scheduled in both the InstallUISequence and the InstallExecuteSequence. The default is 'both'.
Value	String	This attribute specifies a string value to assign to the Directory. The value can be a literal value or derived from a Property element using the Formatted syntax.
Any Attribute (namespace='##other' processContents='lax') Extensibility point in the WiX XML Schema. Schema extensions can register additional attributes at this point in the schema.

previous page start next page