WiX Database XML Schema

Element: File

Description

File specification for File table, must be child node of Component.

Derived By

Restricting anyType

Attributes

Name  Type  Description 
Id  string  The unique identifier for this File element.
CompanionFile  string  Set this attribute to make this file a companion child of another file.
Name  LongFileNameType  In prior versions of the WiX toolset, this attribute specified the short file name. This attribute's value may now be either a short or long file name.
LongName  LongFileNameType   
KeyPath  YesNoType  Set to yes in order to force this file to be the key path for the parent component.
ShortName  ShortFileNameType  The short file name of the file in 8.3 format.
ReadOnly  YesNoType  Set to yes in order to have the file's read-only attribute set when it is installed on the target machine.
Hidden  YesNoType  Set to yes in order to have the file's hidden attribute set when it is installed on the target machine.
System  YesNoType  Set to yes in order to have the file's system attribute set when it is installed on the target machine.
Vital  YesNoType  If a file is vital, then installation cannot proceed unless the file is successfully installed.
Checksum  YesNoType  This attribute should be set to "yes" for every executable file in the installation that has a valid checksum stored in the Portable Executable (PE) file header.
Compressed  YesNoDefaultType  Sets the file's source type compression.
BindPath  string  A list of paths, separated by semicolons, that represent the paths to be searched to find the imported DLLs.
SelfRegCost  integer  The cost of registering the file in bytes.
TrueType  YesNoType  Causes an entry to be generated for the file in the Font table with no FontTitle specified.
FontTitle  string  Causes an entry to be generated for the file in the Font table with the specified FontTitle.
DefaultLanguage  string  This is the default language of this file.
DefaultSize  integer  This is the default size of this file.
DefaultVersion  string  This is the default version of this file.
Assembly  NMTOKEN (restriction)  Specifies if this File is a Win32 Assembly or .NET Assembly that needs to be installed into the Global Assembly Cache.
AssemblyManifest  string  Specifies the file identifier of the manifest file that describes this assembly.
AssemblyApplication  string  Specifies the file identifier of the application file.
ProcessorArchitecture  NMTOKEN (restriction)  Specifies the architecture for this assembly.
DiskId  integer  Specifies the Media this File should be sourced on.
Source  string  Specifies the path to the File in the build process.
src  string   
PatchGroup  integer  This attribute must be set for patch-added files.
PatchIgnore  YesNoType  Prevents the updating of the file that is in fact changed in the upgraded image relative to the target images.
PatchAllowIgnoreOnError  YesNoType  Set to indicate that the patch is non-vital.
PatchWholeFile  YesNoType  Set if the entire file should be installed rather than creating a binary patch.

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.

AssemblyName  anyType (restriction)  The MsiAssemblyName table specifies the schema for the elements of a strong assembly cache name for a .NET Framework or Win32 assembly.

Class  anyType (restriction)  COM Class registration for parent Component.
CopyFile  anyType (restriction)  Copy or move an existing file on the target machine, or copy a file that is being installed, to another destination.
ODBCDriver  anyType (restriction)  ODBCDriver for a Component
ODBCTranslator  anyType (restriction)  ODBCTranslator for a Component
Permission  anyType (restriction)  Sets ACLs on File, Registry, or CreateFolder.
Shortcut  anyType (restriction)  Shortcut, default target is parent File, CreateFolder, or Component's Directory
SymbolPath  anyType (restriction)  A path to symbols.
TypeLib  anyType (restriction)  Register a type library (TypeLib).