Element: DirectoryRef

Description

Create a reference to a Directory element in another Fragment.

Derived By

Restricting anyType

Attributes

Name	Type	Required?	Default	Description
Id	string	Yes		The identifier of the Directory element to reference.
DiskId	integer	No		Sets the default disk identifier for the files contained in this directory.
FileSource	string	No		Used to set the file system source for this directory ref's child elements.
src	string	No

Content Model

Contains elements as defined in the following table.

Component	Type	Occurs	Description
		0..*
any		1..1	Allow any element from the ##other namespace.
Component	anyType (restriction)	1..1	Component for parent Directory
Directory	anyType (restriction)	1..1	Directory layout for the product.
Merge	anyType (restriction)	1..1	Merge directive to bring in a merge module that will be redirected to the parent directory.

Referenced By

• Element Fragment

Definition

<xs:element name="DirectoryRef">
  <xs:annotation>
    <xs:documentation>Create a reference to a Directory element in another Fragment.</xs:documentation>
    <xs:appinfo>
      <xse:seeAlso ref="Directory" xmlns:xse="http://schemas.microsoft.com/wix/2005/XmlSchemaExtension" />
      <xse:howtoRef href="add_a_file.htm" xmlns:xse="http://schemas.microsoft.com/wix/2005/XmlSchemaExtension">How To: Add a file to your installer</xse:howtoRef>
    </xs:appinfo>
  </xs:annotation>
  <xs:complexType>
    <xs:choice minOccurs="0" maxOccurs="unbounded">
      <xs:element ref="Component" />
      <xs:element ref="Directory" />
      <xs:element ref="Merge" />
      <xs:any namespace="##other" processContents="lax">
        <xs:annotation>
          <xs:documentation>
                        Extensibility point in the WiX XML Schema.  Schema extensions can register additional
                        elements at this point in the schema.
                    </xs:documentation>
        </xs:annotation>
      </xs:any>
    </xs:choice>
    <xs:attribute name="Id" type="xs:string" use="required">
      <xs:annotation>
        <xs:documentation>The identifier of the Directory element to reference.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute name="DiskId" type="xs:integer">
      <xs:annotation>
        <xs:documentation>
                        Sets the default disk identifier for the files contained in this directory.
                        This attribute must be set on a Component, Directory, or DirectoryRef element or all of its children File
                        elements, else the default disk identifier of 1 is assumed. The value of this attribute should correspond to the Id attribute of a
                        Media element authored elsewhere.  By creating this connection between a component (or
                        particular files), you set the packaging options to the values specified in the Media
                        element (values such as compression level, cab embedding, etc...).
                    </xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute name="FileSource" type="xs:string">
      <xs:annotation>
        <xs:documentation>Used to set the file system source for this directory ref's child elements.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute name="src" type="xs:string">
      <xs:annotation>
        <xs:appinfo>
          <xse:deprecated ref="FileSource" xmlns:xse="http://schemas.microsoft.com/wix/2005/XmlSchemaExtension" />
        </xs:appinfo>
      </xs:annotation>
    </xs:attribute>
    <xs:anyAttribute namespace="##other" processContents="lax">
      <xs:annotation>
        <xs:documentation>
                    Extensibility point in the WiX XML Schema.  Schema extensions can register additional
                    attributes at this point in the schema.
                </xs:documentation>
      </xs:annotation>
    </xs:anyAttribute>
  </xs:complexType>
</xs:element>

---