Element: FileSearchRef

Description

References an existing FileSearch element.

Derived By

Restricting anyType

Attributes

Name	Type	Required?	Default	Description
Id	string	Yes		Specify the Id to the FileSearch to reference.

Content Model

Always empty.

Referenced By

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

Definition

<xs:element name="FileSearchRef">
  <xs:annotation>
    <xs:appinfo>
      <xse:seeAlso ref="FileSearch" 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 FileSearchRef to reference a FileSearch but they have different parent elements, you must use a FileSearch instead of a FileSearchRef. This is because the DrLocator table in an installer package is keyed on the Id, Parent, and Path. A file is associated with its parent directory in the DrLocator table. When a FileSearch and a FileSearchRef element are under different parent elements, the Parent will automatically be different so a FileSearchRef will not have a FileSearch to reference.</html:p>
      </xse:remarks>
    </xs:appinfo>
    <xs:documentation>References an existing FileSearch element.</xs:documentation>
  </xs:annotation>
  <xs:complexType>
    <xs:attribute name="Id" use="required" type="xs:string">
      <xs:annotation>
        <xs:documentation>Specify the Id to the FileSearch to reference.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
  </xs:complexType>
</xs:element>

---