Element: DirectorySearchRef

Description

References an existing DirectorySearch element.

Derived By

Restricting anyType

Attributes

Name	Type	Required?	Default	Description
Id	string	Yes		Id of the search being referred to.
Parent	string	No		This attribute is the signature of the parent directory of the file or directory in the Signature_ column.
Path	string	No		Path on the user's system. Either absolute, or relative to containing directories.
AssignToProperty	YesNoType	No		Set the result of this search to the value of the outer Property.

Content Model

Contains elements as defined in the following table.

Component	Type	Occurs	Description
		0..1
DirectorySearch	anyType (restriction)	1..1	Searches for directory and assigns to value of parent Property.
DirectorySearchRef	anyType (restriction)	1..1	References an existing DirectorySearch element.
FileSearch	anyType (restriction)	1..1	Searches for file and assigns to fullpath value of parent Property
FileSearchRef	anyType (restriction)	1..1	References an existing FileSearch element.

Referenced By

• Element ComplianceDrive
• Element ComponentSearch
• Element DirectorySearch
• Element DirectorySearchRef
• Element IniFileSearch
• Element RegistrySearch

Definition

<xs:element name="DirectorySearchRef">
  <xs:annotation>
    <xs:appinfo>
      <xse:seeAlso ref="ComponentSearch" xmlns:xse="http://schemas.microsoft.com/wix/2005/XmlSchemaExtension" />
      <xse:seeAlso ref="IniFileSearch" xmlns:xse="http://schemas.microsoft.com/wix/2005/XmlSchemaExtension" />
      <xse:seeAlso ref="RegistrySearch" xmlns:xse="http://schemas.microsoft.com/wix/2005/XmlSchemaExtension" />
      <xse:remarks xmlns:xse="http://schemas.microsoft.com/wix/2005/XmlSchemaExtension">
        <html:p xmlns:html="http://www.w3.org/1999/xhtml">If you intend to use a DirectorySearchRef to reference a DirectorySearch but they have different parent elements, you must use a DirectorySearch instead of a DirectorySearchRef. This is because the DrLocator table in an installer package is keyed on the Id, Parent, and Path. When a DirectorySearch and a DirectorySearchRef element are under different parent elements, the Parent will automatically be different so a DirectorySearchRef will not have a DirectorySearch to reference.</html:p>
      </xse:remarks>
    </xs:appinfo>
    <xs:documentation>References an existing DirectorySearch element.</xs:documentation>
  </xs:annotation>
  <xs:complexType>
    <xs:choice minOccurs="0">
      <xs:element ref="DirectorySearch" />
      <xs:element ref="DirectorySearchRef" />
      <xs:element ref="FileSearch" />
      <xs:element ref="FileSearchRef" />
    </xs:choice>
    <xs:attribute name="Id" use="required" type="xs:string">
      <xs:annotation>
        <xs:documentation>Id of the search being referred to.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute name="Parent" type="xs:string">
      <xs:annotation>
        <xs:documentation>This attribute is the signature of the parent directory of the file or directory in the Signature_ column. If this field is null, and the Path column does not expand to a full path, then all the fixed drives of the user's system are searched by using the Path.  This field is a key into one of the following tables: the RegLocator, the IniLocator, the CompLocator, or the DrLocator tables.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute name="Path" type="xs:string">
      <xs:annotation>
        <xs:documentation>Path on the user's system. Either absolute, or relative to containing directories.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute name="AssignToProperty" type="YesNoType">
      <xs:annotation>
        <xs:documentation>Set the result of this search to the value of the outer Property.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
  </xs:complexType>
</xs:element>

---