Element: SetDirectory

Description

Sets a Directory to a particular value.

Derived By

Extending string

Attributes

Name	Type	Required?	Default	Description
Id	string	No		This attribute specifies a reference to a Directory element with matching Id attribute.
Sequence	NMTOKEN (restriction)	No		Controls which sequences the Directory assignment is sequenced in.
Value	string	No		This attribute specifies a string value to assign to the Directory.

Content Model

Contains text only.

Referenced By

• Element Fragment

Remarks

This is accomplished by creating a Type 51 custom action that is appropriately scheduled in
the InstallUISequence and InstallExecuteSequence.

Definition

<xs:element name="SetDirectory">
  <xs:annotation>
    <xs:appinfo>
      <xse:seeAlso ref="Custom" xmlns:xse="http://schemas.microsoft.com/wix/2005/XmlSchemaExtension" />
      <xse:seeAlso ref="CustomActionRef" xmlns:xse="http://schemas.microsoft.com/wix/2005/XmlSchemaExtension" />
      <xse:seeAlso ref="InstallUISequence" xmlns:xse="http://schemas.microsoft.com/wix/2005/XmlSchemaExtension" />
      <xse:seeAlso ref="InstallExecuteSequence" xmlns:xse="http://schemas.microsoft.com/wix/2005/XmlSchemaExtension" />
      <xse:msiRef table="CustomAction" href="http://msdn.microsoft.com/library/aa368062.aspx" xmlns:xse="http://schemas.microsoft.com/wix/2005/XmlSchemaExtension" />
    </xs:appinfo>
    <xs:documentation>
                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.
            </xs:documentation>
  </xs:annotation>
  <xs:complexType>
    <xs:simpleContent>
      <xs:extension base="xs:string">
        <xs:annotation>
          <xs:documentation>
                        The condition that determines whether the Directory is set. If the condition evaluates to false, the SetDirectory is skipped.
                    </xs:documentation>
        </xs:annotation>
        <xs:attribute name="Id" type="xs:string">
          <xs:annotation>
            <xs:documentation>
                                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.
                            </xs:documentation>
          </xs:annotation>
        </xs:attribute>
        <xs:attribute name="Sequence">
          <xs:annotation>
            <xs:documentation>
                                Controls which sequences the Directory assignment is sequenced in. The default is both.
                            </xs:documentation>
          </xs:annotation>
          <xs:simpleType>
            <xs:restriction base="xs:NMTOKEN">
              <xs:enumeration value="both">
                <xs:annotation>
                  <xs:documentation>
                                            Schedules the assignment in the InstallUISequence and the InstallExecuteSequence.
                                        </xs:documentation>
                </xs:annotation>
              </xs:enumeration>
              <xs:enumeration value="execute">
                <xs:annotation>
                  <xs:documentation>
                                            Schedules the assignment only in the the InstallExecuteSequence.
                                        </xs:documentation>
                </xs:annotation>
              </xs:enumeration>
              <xs:enumeration value="ui">
                <xs:annotation>
                  <xs:documentation>
                                            Schedules the assignment only in the the InstallUISequence.
                                        </xs:documentation>
                </xs:annotation>
              </xs:enumeration>
            </xs:restriction>
          </xs:simpleType>
        </xs:attribute>
        <xs:attribute name="Value" type="xs:string">
          <xs:annotation>
            <xs:documentation>
                                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 <html:a href="http://msdn.microsoft.com/library/aa368609.aspx" target="_blank" xmlns:html="http://www.w3.org/1999/xhtml">Formatted</html:a>
                                syntax.
                            </xs:documentation>
          </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:extension>
    </xs:simpleContent>
  </xs:complexType>
</xs:element>

---