如何在 Visual C# .NET 中将程序集安装到全局程序集缓存中

文章翻译 文章翻译
文章编号: 815808 - 查看本文应用于的产品
展开全部 | 关闭全部

本文内容

概要

本文介绍如何为程序集生成强名称,以及如何在全局程序集缓存 (GAC) 中安装 DLL 文件。通过 GAC,您可以在许多应用程序之间共享程序集。GAC 随 .NET 运行库一起自动安装。组件通常存储在 C:\WINNT\Assembly 中。

要在 GAC 中安装程序集,必须为程序集指定强名称。该名称是加密的哈希密钥或签名。这种强名称可确保正确的组件版本控制。这有助于防止具有相同名称的组件相互冲突或被消耗应用程序误用。


要求

下面概括列出了推荐的硬件、软件、网络结构以及所需的 Service Pack:
  • 对安装共享程序集的计算机的管理员权限

本文假定您熟悉下列主题:
  • 大体熟悉 .NET 中的程序集
  • 大体熟悉从命令提示符处使用工具

全局程序集缓存

要使用 Visual Studio .NET 创建小型类库项目、生成强名称,以及在 GAC 中安装项目的 .dll 文件,请按照下列步骤操作:
  1. 在 Visual Studio .NET 中,创建一个新 Visual C# .NET 类库项目,并将该项目命名为 GACDemo
  2. 必须使用强名称。要生成此加密密钥对,请使用 SN 工具。此工具位于安装 .NET Framework 解决方案开发人员工具包 (SDK) 的 \bin 子目录中。SN 工具易于使用。命令行语句采用以下形式:
    sn -k "[DriveLetter]:\[DirectoryToPlaceKey]\[KeyName].snk"
  3. 在 C:\ 中创建一个名为 GACKey 的目录,以便您可以轻松地找到密钥,并从命令提示符处访问该密钥。

    注意:对于大多数用户,.NET 工具位于 C:\Program Files\Microsoft.NET\FrameworkSDK\Bin 中。键入以下 SN 命令前,可能需要在您的计算机上将与该路径类似的路径复制到 .NET bin 目录中。从命令提示符处键入 cd,右键单击以粘贴该路径,然后按 Enter,快速转至 SN 工具所在的目录。

    键入以下内容:
    sn -k "C:\GACKey\GACkey.snk"
  4. 将生成一个密钥,但是它与项目的程序集尚无关联。要建立此关联,请在 Visual Studio .NET 解决方案资源管理器中双击 AssemblyInfo.cs 文件。此文件具有一个程序集属性列表,默认情况下,在 Visual Studio .NET 中创建项目时将包括这些属性。在代码中修改“AssemblyKeyFile”程序集属性,如下所示:
    [assembly:AssemblyKeyFile("C:\\GACKey\\GACKey.snk")]
    通过按 Ctrl+Shift+B 来编译项目。您不必具有任何附加代码即可以在 GAC 中安装 .dll 文件。
  5. 您可以通过使用 Gacutil 工具或者通过将 .dll 文件拖至适当的目录来安装 .dll 文件。如果您使用 Gacutil 工具,则可以使用以下命令:
    gacutil -I "[DriveLetter]:\[PathToBinDirectoryInVSProject]\gac.dll"
    如果您要拖动文件,请使用 Microsoft Windows 资源管理器。打开 Windows 资源管理器的两个实例。在一个实例中,找到控制台项目的 .dll 文件输出的位置。在另一实例中,找到 c:\[SystemRoot]\Assembly。

    将您的 .dll 文件拖到“Assembly”文件夹中。

完整代码列表 (AssemblyInfo.cs)

using System.Reflection;
using System.Runtime.CompilerServices;

//
// General Information about an assembly is controlled through the following 
// set of attributes. Change these attribute values to modify the information
// that is associated with an assembly.
//
[assembly: AssemblyTitle("")]
[assembly: AssemblyDescription("")]
[assembly: AssemblyConfiguration("")]
[assembly: AssemblyCompany("")]
[assembly: AssemblyProduct("")]
[assembly: AssemblyCopyright("")]
[assembly: AssemblyTrademark("")]
[assembly: AssemblyCulture("")]

//
// Version information for an assembly is made up of the following four values:
//
//      Major Version
//      Minor Version 
//      Build Number
//      Revision
//
// You can specify all the values, or you can default the revision and build numbers 
// by using the '*' as shown below:

[assembly: AssemblyVersion("1.0.*")]

//
// To sign your assembly you must specify a key to use. See the 
// Microsoft .NET Framework documentation for more information about assembly signing.
//
// Use the following attributes to control that key is used for signing. 
//
// Notes: 
//   (*) If no key is specified, the assembly is not signed.
//   (*) KeyName refers to a key that has been installed in the Crypto Service
//       Provider (CSP) on your computer. KeyFile refers to a file that contains
//       a key.
//   (*) If the KeyFile and the KeyName values are both specified, the 
//       following processing occurs:
//       (1) If the KeyName can be found in the CSP, that key is used.
//       (2) If the KeyName does not exist and the KeyFile does exist, the key 
//           in the KeyFile is installed to the CSP and used.
//   (*) To create a KeyFile, you can use the sn.exe (Strong Name) utility.
//       When specifying the KeyFile, the location of the KeyFile must be
//       relative to the project output directory which is
//       %Project Directory%\obj\<configuration>. For example, if your KeyFile is
//       located in the project directory, you would specify the AssemblyKeyFile 
//       attribute as [assembly: AssemblyKeyFile("..\\..\\mykey.snk")]
//   (*) Delay Signing is an advanced option - see the Microsoft .NET Framework
//       documentation for more information about this.
//
[assembly: AssemblyDelaySign(false)]
[assembly: AssemblyKeyFile("C:\\GACKey\\GACKey.snk")]
[assembly: AssemblyKeyName("")]

验证

  1. 启动 Windows 资源管理器。
  2. 找到 C:\SystemRoot\ 程序集。
  3. 在已安装的 .dll 文件的列表中,您会看到 GACDemo。

参考

有关更多信息,请访问下面的 Microsoft 网站:
将程序集安装到全局程序集缓存中 (Installing an Assembly into the Global Assembly Cache)
http://msdn2.microsoft.com/en-us/library/dkkx7f79(vs.71).aspx
全局程序集缓存 (Global Assembly Cache)
http://msdn2.microsoft.com/en-us/library/yf1d93sz(vs.71).aspx
全局程序集缓存工具 (Global Assembly Cache Tool)
http://msdn2.microsoft.com/en-us/library/ex0ss12c(vs.71).aspx

属性

文章编号: 815808 - 最后修改: 2007年5月21日 - 修订: 2.7
这篇文章中的信息适用于:
  • Microsoft Visual C# .NET 2002 标准版
  • Microsoft Visual C# .NET 2003 标准版
  • Microsoft ASP.NET 1.0
  • Microsoft ASP.NET 1.1
关键字:?
kbcodesign kbcommandline kbnamespace kbhowtomaster KB815808
Microsoft和/或其各供应商对于为任何目的而在本服务器上发布的文件及有关图形所含信息的适用性,不作任何声明。 所有该等文件及有关图形均"依样"提供,而不带任何性质的保证。Microsoft和/或其各供应商特此声明,对所有与该等信息有关的保证和条件不负任何责任,该等保证和条件包括关于适销性、符合特定用途、所有权和非侵权的所有默示保证和条件。在任何情况下,在由于使用或运行本服务器上的信息所引起的或与该等使用或运行有关的诉讼中,Microsoft和/或其各供应商就因丧失使用、数据或利润所导致的任何特别的、间接的、衍生性的损害或任何因使用而丧失所导致的之损害、数据或利润不负任何责任。

提供反馈

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com