zoukankan      html  css  js  c++  java
  • 全局程序集缓存工具 (Gacutil.exe)

    .NET Framework 2.0
    全局程序集缓存工具使您可以查看和操作全局程序集缓存和下载缓存的内容。
    gacutil [options] [assemblyName | assemblyPath | assemblyListFile]

    参数

    参数 说明

    assemblyName

    程序集的名称。可以提供部分指定的程序集名称(如 myAssembly)或完全指定的程序集名称(如 myAssembly, Version=2.0.0.0, Culture=neutral, PublicKeyToken=0038abc9deabfle5)。

    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

    将程序集安装到全局程序集缓存中,并添加引用以对程序集进行计数。使用此选项时必须指定 assemblyPathschemeiddescription 参数。有关可为这些参数指定的有效值的说明,请参见 /r 选项。

    指定此选项相当于同时指定 /i/r 选项。

    /l [assemblyName]

    列出全局程序集缓存的内容。如果指定 assemblyName 参数,则全局程序集缓存工具只列出与该名称匹配的程序集。

    /ldl

    列出下载文件缓存的内容。

    /lr [assemblyName]

    列出所有程序集及其相应的引用数。如果指定 assemblyName 参数,则该工具只列出与该名称匹配的程序集及其相应的引用数。

    /nologo

    取消显示 Microsoft 启动标题。

    /r [assemblyName | assemblyPath]

    scheme

    id

    description

    指定对要安装或卸载的一个或多个程序集的跟踪引用。与 /i/il/u/ul 选项一起指定此选项。

    若要安装程序集,请在使用此选项的同时指定 assemblyPathschemeiddescription 参数。若要卸载程序集,请指定 assemblyNameschemeiddescription 参数。

    若要移除对程序集的引用,必须指定在安装程序集时使用 /i/r(或 /ir)选项指定的 schemeiddescription 参数。如果卸载程序集,则全局程序集缓存工具还从全局程序集缓存中移除该程序集,条件是它是最后一个要移除的引用,并且 Windows Installer 没有对该程序集的未决引用。

    scheme 参数指定安装方案的类型。可以指定以下值之一:

    • UNINSTALL_KEY:如果安装程序将应用程序添加到 Microsoft Windows 中的“添加/删除程序”,则指定该值。应用程序通过将注册表项添加到 HKLM\Software\Microsoft\Windows\CurrentVersion 中而将自己添加到“添加/删除程序”中。

    • FILEPATH:如果安装程序没有将应用程序添加到“添加/删除程序”中,则指定该值。

    • OPAQUE:如果提供的注册表项或文件路径不适于您的安装方案,则指定该值。该值允许您为 id 参数指定自定义信息。

    id 参数指定的值取决于为 scheme 参数指定的值:

    • 如果为 scheme 参数指定 UNINSTALL_KEY,请在 HKLM\Software\Microsoft\Windows\CurrentVersion 注册表项中指定应用程序集的名称。例如,如果注册表项是 HKLM\Software\Microsoft\Windows\CurrentVersion\MyApp,请指定 MyApp 作为 id 参数。

    • 如果为 scheme 参数指定 FILEPATH,请将安装程序集的可执行文件的完整路径指定为 id 参数。

    • 如果为 scheme 参数指定 OPAQUE,则可以将任何一段数据作为 id 参数提供。所指定的数据必须用引号 ("") 括起来。

    description 参数允许您指定关于要安装的应用程序的描述性文本。当枚举引用时,显示此信息。

    /silent

    取消所有输出的显示。

    /u assemblyName

    从全局程序集缓存中卸载程序集。

    /uf assemblyName

    通过移除对程序集的所有引用来强制卸载指定的程序集。

    指定此选项相当于同时指定 /u/f 选项。

    Note注意

    不能使用此选项移除使用 Microsoft Windows Installer 所安装的程序集。如果尝试此操作,则全局程序集缓存工具显示错误信息。

    /ul assemblyListFile

    从全局程序集缓存中卸载 assemblyListFile 中指定的一个或多个程序集。

    /u[ngen] assemblyName

    从全局程序集缓存中卸载指定的程序集。如果指定的程序集存在现有引用数,则全局程序集缓存工具显示引用数,而且不从全局程序集缓存中移除该程序集。

    Note注意

    在 .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)选项指定的 schemeiddescription 参数。有关可为这些参数指定的有效值的说明,请参见 /r 选项。

    指定此选项相当于同时指定 /u/r 选项。

    /?

    显示该工具的命令语法和选项。

    全局程序集缓存工具提供与 Windows 外壳程序扩展 (Shfusion.dll) 大致相同的缓存查看功能,但它更适于生成脚本、生成文件和批处理文件。

    具体说来,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 安装到全局程序集缓存中。
    /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"

    以下命令移除应用程序 myAppmyDll.dll 的引用。如果这是对该程序集的最后一个引用,则将同时从全局程序集缓存中移除该程序集。

    gacutil /u /r myDll.dll FILEPATH c:\applications\myApp\myApp.exe MyApp

    下面的命令列出全局程序集缓存的内容。

     
    gacutil /l
  • 相关阅读:
    HDU 5273 Dylans loves sequence 暴力递推
    HDU 5285 wyh2000 and pupil 判二分图+贪心
    HDU 5281 Senior's Gun 贪心
    HDU 5651 xiaoxin juju needs help 逆元
    HDU 5646 DZY Loves Partition
    HDU 5366 The mook jong
    HDU 5391Z ball in Tina Town 数论
    HDU 5418 Victor and World 允许多次经过的TSP
    HDU 5642 King's Order dp
    抽屉原理
  • 原文地址:https://www.cnblogs.com/luoyaoquan/p/2025553.html
Copyright © 2011-2022 走看看