MT 任务

注意

仅当使用 C++ 生成系统时,此任务才可用。

包装 Microsoft 清单工具 mt.exe 。 有关详细信息,请参见 Mt.exe

参数

下表描述了 MT 任务的参数。 大多数任务参数和若干组参数都对应于命令行选项。

注意

mt.exe 文档使用连字符 (-) 作为前缀,用于命令行选项,但本主题使用斜杠 (/)。 以上任意一种前缀都是可接受的。

参数 描述
AdditionalManifestFiles 可选 String [] 参数。

指定一个或多个清单文件的名称。

有关详细信息,请参阅 Mt.exe 中的“/manifest”选项。
AdditionalOptions 可选 String 参数。

命令行选项列表。 例如 /<option1> /<option2> /<option#>。 使用此参数可指定未由任何其他 MT 任务参数表示的命令行选项。

有关详细信息,请参见 Mt.exe
AssemblyIdentity 可选 String 参数。

指定清单的 assemblyIdentity 元素的特性值。 指定一个逗号分隔的列表,其中第一个组件是 name 属性的值,后跟以下格式的一个或多个名称/值对:<attribute name>=<attribute_value>。

有关详细信息,请参阅 Mt.exe 中的“/identity”选项。
ComponentFileName 可选 String 参数。

指定要从 .rgs 或 .tlb 文件生成的动态链接库的名称。 如果指定 RegistrarScriptFile 或 TypeLibraryFile MT 任务参数,则此参数为必需。

有关详细信息,请参阅 Mt.exe 中的“/dll”选项。
DependencyInformationFile 可选 String 参数。

指定 Visual Studio 用来跟踪清单工具的生成依赖项信息的依赖项信息文件。
EmbedManifest 可选 Boolean 参数。

如果为 true,则在程序集中嵌入清单文件。 如果为 false,则会创建为独立的清单文件。
EnableDPIAwareness 可选枚举参数。

值为 falsetruePerMonitorHighDpiAware。 如果为 true,则将信息添加到将应用程序标记为可识别 DPI 的清单。 编写可识别 DPI 的应用程序,可使用户界面通过各种高 DPI 显示设置显得美观一致。 如果为 PerMonitorHighDpiAware,则将信息添加到将应用程序标记为可识别每监视器 DPI 的清单。 默认值为 false,但如果将 $(UseOfMFC) 设置为 staticdynamic,默认值将变为 true

有关详细信息,请参见高 DPI
GenerateCatalogFiles 可选 Boolean 参数。

如果为 true,则生成目录定义 (.cdf ) 文件。

有关详细信息,请参阅 Mt.exe 中的“/makecdfs”选项。
GenerateCategoryTags 可选 Boolean 参数。

如果为 true,则会导致生成类型标记。 如果此参数为 true,还必须指定 ManifestFromManagedAssemblyMT 任务参数。

有关详细信息,请参阅 Mt.exe 中的“/category”选项。
InputResourceManifests 可选 String 参数。

从具有指定标识符的 RT_MANIFEST 类型的资源输入清单。 指定格式为 <file>[;[#]<resource_id>] 的资源,其中可选 <resource_id> 参数是一个非负 16 位数字。

如果没有指定 resource_id,则会使用 CREATEPROCESS_MANIFEST_RESOURCE 默认值 (1)。

有关详细信息,请参阅 Mt.exe 中的“/inputresource”选项。
ManifestFromManagedAssembly 可选 String 参数。

从指定的托管程序集生成清单。

有关详细信息,请参阅 Mt.exe 中的“/managedassemblyname”选项。
ManifestToIgnore 可选 String 参数。

(未使用。)
OutputManifestFile 可选 String 参数。

指定输出清单的名称。 如果省略了此参数,并且只有一个清单正在进行操作,则会就地修改该清单。

有关详细信息,请参阅 Mt.exe 中的“/out”选项。
OutputResourceManifests 可选 String 参数。

将清单输出到具有指定标识符的 RT_MANIFEST 类型的资源。 此资源格式为 <file>[;[#]<resource_id>],其中可选 <resource_id> 参数是一个非负 16 位数字。

如果没有指定 resource_id,则会使用 CREATEPROCESS_MANIFEST_RESOURCE 默认值 (1)。

有关详细信息,请参阅 Mt.exe 中的“/outputresource”选项。
RegistrarScriptFile 可选 String 参数。

指定要用于免注册 COM 清单支持的注册器脚本 (.rgs ) 文件。

有关详细信息,请参阅 Mt.exe 中的“/rgs”选项。
ReplacementsFile 可选 String 参数。

指定注册器脚本 (.rgs ) 文件中包含可替换字符串的值的文件。

有关详细信息,请参阅 Mt.exe 中的“/replacements”选项。
ResourceOutputFileName 可选 String 参数。

指定用于将清单嵌入项目输出的输出资源文件。
Sources 可选 ITaskItem[] 参数。

指定用空格分隔的清单源文件列表。

有关详细信息,请参阅 Mt.exe 中的“/manifest”选项。
SuppressDependencyElement 可选 Boolean 参数。

如果为 true,则生成无依赖项元素的清单。 如果此参数为 true,还需指定 ManifestFromManagedAssemblyMT 任务参数。

有关详细信息,请参阅 Mt.exe 中的“/nodependency”选项。
SuppressStartupBanner 可选 Boolean 参数。

如果为 true,则在任务开始时阻止显示版权和版本号消息。

有关详细信息,请参阅 Mt.exe 中的“/nologo”选项。
TrackerLogDirectory 可选 String 参数。

指定存储此任务跟踪日志的中间目录。
TypeLibraryFile 可选 String 参数。

指定类型库 (.tlb ) 文件的名称。 如果指定此参数,还要指定 ComponentFileNameMT 任务参数。

有关详细信息,请参阅 Mt.exe 中的“/tlb”选项。
UpdateFileHashes 可选 Boolean 参数。

如果为 true,将在 UpdateFileHashesSearchPathMT 任务参数指定的路径计算文件的哈希值,然后使用计算的值更新清单 file 元素的 hash 特性的值。

有关详细信息,请参阅 Mt.exe 中的“/hashupdate”选项。 另请参阅此表中的 UpdateFileHashesSearchPath 参数。
UpdateFileHashesSearchPath 可选 String 参数。

指定更新文件哈希时要使用的搜索路径。 将此参数与 UpdateFileHashesMT 任务参数一起使用。

有关详细信息,请参阅此表中的 UpdateFileHashes 参数。
VerboseOutput 可选 Boolean 参数。

如果为 true,则显示详细调试信息。

有关详细信息,请参阅 Mt.exe 中的“/verbose”选项。

请参阅