全局程序集缓存工具 (Gacutil.exe)
全局程序集缓存工具使您可以查看和操作全局程序集缓存和下载缓存的内容。
gacutil [options] [assemblyName | assemblyPath | assemblyListFile]
参数
参数 | 说明 |
---|---|
assemblyName |
程序集的名称。可以提供部分指定的程序集名称(如 |
assemblyPath |
包含程序集清单的文件的名称。 |
assemblyListFile |
列出要安装或卸载的程序集的 ANSI 文本文件的路径。若要使用文本文件安装程序集,请在文件中的单独一行上分别指定每个程序集的路径。全局程序集缓存工具解释相对于 assemblyListFile 的位置的相对路径。若要使用文本文件卸载程序集,请在文件中的单独一行上分别为每个程序集指定完全限定的程序集名称。请参见本主题后面的 assemblyListFile 内容示例。 |
选项 | 说明 |
---|---|
/cdl |
删除下载缓存的内容。 |
/f |
与 /i 或 /il 选项一起指定此选项将强制重新安装程序集。如果全局程序集缓存中已经存在同名的程序集,全局程序集缓存工具将改写该程序集。 |
/h[elp] |
显示该工具的命令语法和选项。 |
/i assemblyPath |
将程序集安装到全局程序集缓存中。 |
/if assemblyPath |
将程序集安装到全局程序集缓存中。如果全局程序集缓存中已经存在同名的程序集,全局程序集缓存工具将改写该程序集。 指定此选项相当于同时指定 /i 和 /f 选项。 |
/il assemblyListFile |
将 assemblyListFile 中指定的一个或多个程序集安装到全局程序集缓存中。 |
/ir assemblyPath scheme id description |
将程序集安装到全局程序集缓存中,并添加引用以对程序集进行计数。使用此选项时必须指定 assemblyPath、scheme、id 和 description 参数。有关可为这些参数指定的有效值的说明,请参见 /r 选项。 指定此选项相当于同时指定 /i 和 /r 选项。 |
/l [assemblyName] |
列出全局程序集缓存的内容。如果指定 assemblyName 参数,则全局程序集缓存工具只列出与该名称匹配的程序集。 |
/ldl |
列出下载文件缓存的内容。 |
/lr [assemblyName] |
列出所有程序集及其相应的引用数。如果指定 assemblyName 参数,则该工具只列出与该名称匹配的程序集及其相应的引用数。 |
/nologo |
取消显示 Microsoft 启动标题。 |
/r [assemblyName | assemblyPath] scheme id description |
指定对要安装或卸载的一个或多个程序集的跟踪引用。与 /i、/il、/u 或 /ul 选项一起指定此选项。 若要安装程序集,请在使用此选项的同时指定 assemblyPath、scheme、id 和 description 参数。若要卸载程序集,请指定 assemblyName、scheme、id 和 description 参数。 若要移除对程序集的引用,必须指定在安装程序集时使用 /i 和 /r(或 /ir)选项指定的 scheme、id 和 description 参数。如果卸载程序集,则全局程序集缓存工具还从全局程序集缓存中移除该程序集,条件是它是最后一个要移除的引用,并且 Windows Installer 没有对该程序集的未决引用。 scheme 参数指定安装方案的类型。可以指定以下值之一:
为 id 参数指定的值取决于为 scheme 参数指定的值:
description 参数允许您指定关于要安装的应用程序的描述性文本。当枚举引用时,显示此信息。 |
/silent |
取消所有输出的显示。 |
/u assemblyName |
从全局程序集缓存中卸载程序集。 |
/uf assemblyName |
通过移除对程序集的所有引用来强制卸载指定的程序集。 指定此选项相当于同时指定 /u 和 /f 选项。 备注 不能使用此选项移除使用 Microsoft Windows Installer 所安装的程序集。如果尝试此操作,则全局程序集缓存工具显示错误信息。 |
/ul assemblyListFile |
从全局程序集缓存中卸载 assemblyListFile 中指定的一个或多个程序集。 |
/u[ngen] assemblyName |
从全局程序集缓存中卸载指定的程序集。如果指定的程序集存在现有引用数,则全局程序集缓存工具显示引用数,而且不从全局程序集缓存中移除该程序集。 备注 在 .NET Framework 2.0 版中,不支持 /ungen。而是使用 本机映像生成器 (Ngen.exe) 的 uninstall 命令。 在 .NET Framework 1.0 和 1.1 版中,指定 /ungen 将使 Gacutil.exe 从本机映像缓存中移除该程序集。此缓存存储了使用 本机映像生成器 (Ngen.exe) 创建的程序集的本机映像。 |
/ur assemblyName scheme id description |
从全局程序集缓存中卸载对指定程序集的引用。若要移除对程序集的引用,必须指定在安装程序集时使用 /i 和 /r(或 /ir)选项指定的 scheme、id 和 description 参数。有关可为这些参数指定的有效值的说明,请参见 /r 选项。 指定此选项相当于同时指定 /u 和 /r 选项。 |
/? |
显示该工具的命令语法和选项。 |
备注
全局程序集缓存工具提供与 Windows 外壳程序扩展 (Shfusion.dll) 大致相同的缓存查看功能,但它更适于生成脚本、生成文件和批处理文件。
备注
必须具有管理员特权才能使用 Gacutil.exe。
具体说来,Gacutil.exe 使您得以将程序集安装到缓存中、从缓存中移除程序集以及列出缓存的内容。
Gacutil.exe 提供支持引用计数的选项,类似于 Windows Installer 所支持的引用计数方案。您可以使用 Gacutil.exe 安装两个安装同一程序集的应用程序;全局程序集缓存工具跟踪对该程序集的引用数。结果是,该程序集将一直保留在计算机上,直到卸载这两个应用程序为止。如果将 Gacutil.exe 用于实际产品安装,请使用支持引用计数的选项。同时使用 /i 和 /r 选项可以安装程序集并添加引用对其进行计数。同时使用 /u 和 /r 选项可以移除对程序集的引用计数。注意,单独使用 /i 和 /u 选项不支持引用计数。这些选项在产品开发期间适用,但不适用于实际的产品安装。
使用 /il 或 /ul 选项可以安装或卸载存储在 ANSI 文本文件中的程序集。该文本文件中的内容必须具有正确的格式。若要使用文本文件安装程序集,请在文件中的单独一行上分别指定每个程序集的路径。下面的示例说明了包含要安装的程序集的文件的内容。
myAssembly1.dll
myAssembly2.dll
myAssembly3.dll
若要使用文本文件卸载程序集,请在文件中的单独一行上分别为每个程序集指定完全限定的程序集名称。下面的示例说明了包含要卸载的程序集的文件的内容。
myAssembly1,Version=1.1.0.0,Culture=en,PublicKeyToken=874e23ab874e23ab
myAssembly2,Version=1.1.0.0,Culture=en,PublicKeyToken=874e23ab874e23ab
myAssembly3,Version=1.1.0.0,Culture=en,PublicKeyToken=874e23ab874e23ab
示例
以下命令将程序集 mydll.dll
安装到全局程序集缓存中。
gacutil /i mydll.dll
以下命令从全局程序集缓存中移除程序集 hello
(只要不存在对该程序集的引用计数)。
gacutil /u hello
请注意,上面的命令可能会从程序集缓存中移除多个程序集,原因是程序集名称不是完全指定的。例如,如果在该缓存中安装有 hello
的 1.0.0.0 和 3.2.2.1 两个版本,则 gacutil /u hello
命令会将这两个程序集都移除。
使用下面的示例以避免删除多个程序集。该命令只删除与完全指定的版本号、区域性和公钥匹配的 hello
程序集。
gacutil /u hello, Version=1.0.0.1, Culture="de",PublicKeyToken=45e343aae32233ca
以下命令将 assemblyList.txt
文件中指定的程序集安装到全局程序集缓存中。
gacutil /il assemblyList.txt
以下命令从全局程序集缓存中移除 assemblyList.txt
文件中指定的程序集。
gacutil /ul assemblyList.txt
以下命令将 myDll.dll
安装到全局程序集缓存中并添加引用对其进行计算。程序集 myDll.dll
由应用程序 MyApp
使用。UNINSTALL_KEY MyApp
参数指定将 MyApp
添加到 Windows“添加/删除程序”中的注册表项。description 参数被指定为 My Application Description
。
gacutil /i /r myDll.dll UNINSTALL_KEY MyApp "My Application Description"
以下命令将 myDll.dll
安装到全局程序集缓存中并添加引用对其进行计算。scheme 参数 FILEPATH
和 id 参数 c:\applications\myApp\myApp.exe
指定要安装 myDll.dll
应用程序的路径。description 参数被指定为 MyApp
。
gacutil /i /r myDll.dll FILEPATH c:\applications\myApp\myApp.exe MyApp
以下命令将 myDll.dll
安装到全局程序集缓存中并添加引用对其进行计算。scheme 参数 OPAQUE
允许您自定义 id 和 description 参数。
gacutil /i /r mydll.dll OPAQUE "Insert custom application details here" "Insert Custom description information here"
以下命令移除应用程序 myApp
对 myDll.dll
的引用。如果这是对该程序集的最后一个引用,则将同时从全局程序集缓存中移除该程序集。
gacutil /u /r myDll.dll FILEPATH c:\applications\myApp\myApp.exe MyApp
下面的命令列出全局程序集缓存的内容。
gacutil /l
请参见
参考
.NET Framework 工具
程序集缓存查看器 (Shfusion.dll)
程序集注册工具 (Regasm.exe)
SDK 命令提示