Skip to main content
Version: v3

DirectorySearch Element

Searches for directory and assigns to value of parent Property.
Windows Installer references
DrLocator Table, Signature Table
ComplianceCheck, ComplianceDrive, ComponentSearch, DirectorySearch, DirectorySearchRef, IniFileSearch, Property, RegistrySearch
Inner Text
Choice of elements (min: 0, max: 1)
IdStringUnique identifier for the directory search.Yes
AssignToPropertyYesNoTypeSet the value of the outer Property to the result of this search. See remarks for more information. 
DepthInteger Depth below the path that the installer searches for the file or directory specified by the search. See remarks for more information.  
PathStringPath on the user's system. Either absolute, or relative to containing directories. 

Use the AssignToProperty attribute to search for a file but set the outer property to the directory containing the file. When this attribute is set to 'yes', you may only nest a FileSearch element with a unique Id or define no child element.

When the parent DirectorySearch/@Depth attribute is greater than 0, the FileSearch/@Id attribute must be absent or the same as the parent DirectorySearch/@Id attribute value, unless the parent DirectorySearch/@AssignToProperty attribute value is 'yes'.
How Tos and Examples
See Also
Wix Schema, ComponentSearch, IniFileSearch, RegistrySearch