MT Task
Wraps the Microsoft Manifest Tool, mt.exe. For more information, see "Mt.exe" on the MSDN Web site.
Parameters
The following table describes the parameters of the MT task. Most task parameters, and a few sets of parameters, correspond to a command-line option.
Note
The mt.exe documentation uses a hyphen (-) as the prefix for command-line options, but this topic uses a slash (/). Either prefix is acceptable.
Parameter |
Description |
|---|---|
AdditionalManifestFiles |
Optional String[] parameter. Specifies the name of one or more manifest files. For more information, see the /manifest option in "Mt.exe" on the MSDN Web site. |
AdditionalOptions |
Optional String parameter. A list of command-line options. For example, "/option1 /option2 /option#". Use this parameter to specify command-line options that are not represented by any other MT task parameter. For more information, see "Mt.exe" on the MSDN Web site. |
AssemblyIdentity |
Optional String parameter. Specifies the attribute values of the assemblyIdentity element of the manifest. Specify a comma-delimited list, where the first component is the value of the name attribute, followed by one or more name/value pairs that have the form, <attribute name>=<attribute_value>. For more information, see the /identity option in "Mt.exe" on the MSDN Web site. |
ComponentFileName |
Optional String parameter. Specifies the name of the dynamic-link library you intend to build from the .rgs or .tlb files. This parameter is required if you specify the RegistrarScriptFile or TypeLibraryFile MT task parameters. For more information, see the /dll option in "Mt.exe" on the MSDN Web site. |
DependencyInformationFile |
Optional String parameter. Specifies the dependency information file used by Visual Studio to track build dependency information for the manifest tool. |
EmbedManifest |
Optional Boolean parameter. If true, embeds the manifest file in the assembly. If false, creates as a stand-alone manifest file. |
EnableDPIAwareness |
Optional Boolean parameter. If true, adds to the manifest information that marks the application as DPI-aware. Writing a DPI-aware application makes a user interface look consistently good across a wide variety of high-DPI display settings. For more information, see "High DPI" on the MSDN Web site. |
GenerateCatalogFiles |
Optional Boolean parameter. If true, generates catalog definition (.cdf) files. For more information, see the /makecdfs option in "Mt.exe" on the MSDN Web site. |
GenerateCategoryTags |
Optional Boolean parameter. If true, causes category tags to be generated. If this parameter is true, the ManifestFromManagedAssemblyMT task parameter must also be specified. For more information, see the /category option in "Mt.exe" on the MSDN Web site. |
InputResourceManifests |
Optional String parameter. Input the manifest from a resource of type RT_MANIFEST that has the specified identifier. Specify a resource of the form, <file>[;[#]<resource_id>], where the optional resource_id parameter is a non-negative, 16-bit number. If no resource_id is specified, the CREATEPROCESS_MANIFEST_RESOURCE default value (1) is used. For more information, see the /inputresource option in "Mt.exe" on the MSDN Web site. |
ManifestFromManagedAssembly |
Optional String parameter. Generates a manifest from the specified managed assembly. For more information, see the /managedassemblyname option in "Mt.exe" on the MSDN Web site. |
ManifestToIgnore |
Optional String parameter. (Not used.) |
OutputManifestFile |
Optional String parameter. Specifies the name of the output manifest. If this parameter is omitted and only one manifest is being operated on, that manifest is modified in place. For more information, see the /out option in "Mt.exe" on the MSDN Web site. |
OutputResourceManifests |
Optional String parameter. Output the manifest to a resource of type RT_MANIFEST that has the specified identifier. The resource is of the form, <file>[;[#]<resource_id>], where the optional resource_id parameter is a non-negative, 16-bit number. If no resource_id is specified, the CREATEPROCESS_MANIFEST_RESOURCE default value (1) is used. For more information, see the /outputresource option in "Mt.exe" on the MSDN Web site. |
RegistrarScriptFile |
Optional String parameter. Specifies the name of the registrar script (.rgs) file to use for registration-free COM manifest support. For more information, see the /rgs option in "Mt.exe" on the MSDN Web site. |
ReplacementsFile |
Optional String parameter. Specifies the file that contains values for the replaceable strings in the registrar script (.rgs) file. For more information, see the /replacements option in "Mt.exe" on the MSDN Web site. |
ResourceOutputFileName |
Optional String parameter. Specifies the output resources file used to embed the manifest into the project output. |
Sources |
Optional ITaskItem[] parameter. Specifies a list of manifest source files separated by spaces. For more information, see the /manifest option in "Mt.exe" on the MSDN Web site. |
SuppressDependencyElement |
Optional Boolean parameter. If true, generates a manifest without dependency elements. If this parameter is true, also specify the ManifestFromManagedAssemblyMT task parameter. For more information, see the /nodependency option in "Mt.exe" on the MSDN Web site. |
SuppressStartupBanner |
Optional Boolean parameter. If true, prevents the display of the copyright and version number message when the task starts. For more information, see the /nologo option in "Mt.exe" on the MSDN Web site. |
TrackerLogDirectory |
Optional String parameter. Specifies the intermediate directory where tracking logs for this task are stored. |
TypeLibraryFile |
Optional String parameter. Specifies the name of the type library (.tlb) file. If you specify this parameter, also specify the ComponentFileNameMT task parameter. For more information, see the /tlb option in "Mt.exe" on the MSDN Web site. |
UpdateFileHashes |
Optional Boolean parameter. If true, computes the hash value of the files at the path specified by the UpdateFileHashesSearchPathMT task parameter, and then updates the value of the hash attribute of the file element of the manifest by using the computed value. For more information, see the /hashupdate option in "Mt.exe" on the MSDN Web site. Also see the UpdateFileHashesSearchPath parameter in this table. |
UpdateFileHashesSearchPath |
Optional String parameter. Specifies the search path to use when the file hashes are updated. Use this parameter with the UpdateFileHashesMT task parameter. For more information, see the UpdateFileHashes parameter in this table. |
VerboseOutput |
Optional Boolean parameter. If true, displays verbose debugging information. For more information, see the /verbose option in "Mt.exe" on the MSDN Web site. |