Description
The Fragment element is the building block of creating an installer database in WiX.
Derived By
Restricting anyType
Attributes
| Name |
Type |
Description |
| Id |
string |
Optional identifier for a Fragment.
|
Content Model
Contains elements as defined in the following table.
| Component |
Type |
Description |
| any |
|
Allow any element from the ##other namespace.
|
| AppId |
anyType (restriction) |
Application ID containing DCOM information for the associated application GUID.
|
| Binary |
anyType (restriction) |
Binary data used for CustomAction elements and UI controls.
|
| ComplianceCheck |
anyType (restriction) |
Adds a row to the CCPSearch table.
|
| Component |
anyType (restriction) |
Component for parent Directory
|
| ComponentGroup |
anyType (restriction) |
Groups together multiple components to be used in other locations.
|
| Condition |
string (extension) |
Conditions for components, controls, features, and products.
|
| CustomAction |
string (extension) |
Specifies a custom action to be added to the MSI CustomAction table.
|
| CustomActionRef |
anyType (restriction) |
This will cause the entire contents of the Fragment containing the referenced CustomAction to be included in the installer database.
|
| CustomTable |
anyType (restriction) |
Defines a custom table for use from a custom action.
|
| Directory |
anyType (restriction) |
Directory layout for the product.
|
| DirectoryRef |
anyType (restriction) |
Create a reference to a Directory element in another Fragment.
|
| EmbeddedChainer |
string (extension) |
|
| EmbeddedChainerRef |
anyType (restriction) |
Reference to an EmbeddedChainer element.
|
| EnsureTable |
anyType (restriction) |
Use this element to ensure that a table appears in the installer database, even if its empty.
|
| Feature |
anyType (restriction) |
A feature for the Feature table.
|
| FeatureGroup |
anyType (restriction) |
Groups together multiple components, features, and merges to be used in other locations.
|
| FeatureRef |
anyType (restriction) |
Create a reference to a Feature element in another Fragment.
|
| Icon |
anyType (restriction) |
Icon used for Shortcut, ProgId, or Class elements (but not UI controls)
|
| IgnoreModularization |
anyType (restriction) |
This element has been deprecated.
|
| Media |
anyType (restriction) |
Media element describes a disk that makes up the source media for the installation.
|
| PatchCertificates |
anyType (restriction) |
Identifies the possible signer certificates used to digitally sign patches.
|
| PatchFamily |
anyType (restriction) |
Collection of items that should be kept from the differences between two products.
|
| Property |
anyType (restriction) |
Property value for a Product or Module.
|
| PropertyRef |
anyType (restriction) |
Reference to a Property value.
|
| InstallExecuteSequence |
anyType (restriction) |
|
| InstallUISequence |
anyType (restriction) |
|
| AdminExecuteSequence |
anyType (restriction) |
|
| AdminUISequence |
anyType (restriction) |
|
| AdvertiseExecuteSequence |
anyType (restriction) |
|
| SetDirectory |
string (extension) |
Sets a Directory to a particular value.
|
| SetProperty |
string (extension) |
Sets a Property to a particular value.
|
| SFPCatalog |
anyType (restriction) |
Adds a system file protection update catalog file
|
| UI |
anyType (restriction) |
Enclosing element to compartmentalize UI specifications.
|
| UIRef |
anyType (restriction) |
Reference to a UI element. This will force the entire referenced Fragment's contents to be included in the installer database.
|
| Upgrade |
anyType (restriction) |
Upgrade info for a particular UpgradeCode
|
| WixVariable |
anyType (restriction) |
This element exposes advanced WiX functionality.
|
Remarks
Once defined, the Fragment becomes an immutable, atomic unit which can either be completely included or excluded from a product. The contents of a Fragment element can be linked into a product by utilizing one of the many *Ref elements. When linking in a Fragment, it will be necessary to link in all of its individual units. For instance, if a given Fragment contains two Component elements, you must link both under features using ComponentRef for each linked Component. Otherwise, you will get a linker warning and have a floating Component that does not appear under any Feature.