使用 Visual C# 将程序集安装到全局程序集缓存中
本文介绍如何将程序集安装到 Visual C# 中的全局程序集缓存中。
原始产品版本: Visual C#
原始 KB 数: 815808
摘要
本文介绍如何为程序集生成强名称,以及如何在全局程序集缓存 (GAC) 中安装 .dll 文件。 使用 GAC,可以跨多个应用程序共享程序集。 GAC 随 .NET 运行时一起自动安装。 组件通常存储在 中 C:\WINNT\Assembly
。
若要在 GAC 中安装程序集,必须为程序集提供强名称。 名称是加密哈希密钥或签名。 此强名称可确保正确的组件版本控制。 这有助于防止具有相同名称的组件相互冲突,或被使用的应用程序错误地使用。
要求
- 对安装共享程序集的计算机的管理员权限
- 大致熟悉 .NET 中的程序集。
- 大致熟悉在命令提示符处使用工具。
全局程序集缓存
若要使用 Visual Studio 创建小型类库项目、生成强名称,并在 GAC 中安装项目的 .dll 文件,请执行以下步骤:
在 Visual Studio 中,创建新的 Visual C# 类库项目,并将该项目命名为 GACDemo。
必须使用强名称。 若要生成此加密密钥对,请使用强名称工具 (Sn.exe) 。 此工具位于
\bin
安装.NET Framework解决方案开发人员工具包 (SDK) 的子目录中。 Sn.exe 工具易于使用。 命令行语句采用以下条件sn -k "[DriveLetter]:\[DirectoryToPlaceKey]\[KeyName].snk"
注意
在 Visual Studio 中,可以使用 IDE 项目属性生成密钥对和对程序集进行签名。 然后,可以跳过步骤 3 和步骤 4,也可以跳过对 AssemblyInfo.cs 文件进行任何代码更改。
若要使用 IDE 项目属性生成密钥对并为程序集签名,请执行以下步骤:
在解决方案资源管理器中,右键单击“GACDemo”,然后单击“属性”。
单击“签名”选项卡,然后单击以选中“检查为程序集签名”框。
在 “选择强名称密钥 ”列表中,单击“ <新建...”>。
键入 GACkey.snk 作为密钥文件名,清除“使用密码检查保护密钥文件”框,然后单击“确定”。
按 Ctrl+Shift+B 键盘快捷方式编译项目。
执行这些步骤后,仍必须按照步骤 5 在 GAC 中安装程序集。
在 中创建
C:\
名为 GACKey 的目录,以便可以轻松找到密钥,并在命令提示符处访问密钥。对于大多数用户,.NET 工具位于 中
C:\Program Files\Microsoft.NET\FrameworkSDK\Bin
。 在键入以下命令之前,可能需要将计算机上的此类似路径复制到 .NET bin 目录。 在命令提示符处键入cd
,右键单击以粘贴路径,然后按 Enter 快速更改为 SN 工具所在的目录。键入以下命令:
sn -k "C:\GACKey\GACkey.snk"
生成了一个密钥,但它尚未与项目的程序集关联。 若要创建此关联,请在 Visual Studio .NET 解决方案资源管理器 中双击 AssemblyInfo.cs 文件。 此文件包含在 Visual Studio .NET 中创建项目时默认包含的程序集属性列表。
AssemblyKeyFile
修改代码中的程序集属性,如下所示:[assembly: AssemblyKeyFile('C:\\GACKey\\GACKey.snk') ]
按 Ctrl+Shift+B 编译项目。 无需任何其他代码即可在 GAC 中安装 .dll 文件。
可以使用 Gacutil 工具或将 .dll 文件拖动到相应的文件夹来安装 .dll 文件。 如果使用 Gacutil 工具,则可以使用类似于以下内容的命令:
gacutil -I "[DriveLetter]:\[PathToBinDirectoryInVSProject]\gac.dll"
若要拖动文件,请打开 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("")]
验证
- 启动 Windows 资源管理器。
- 找到
C:\SystemRoot\assembly
。 - 已安装的 .dll 文件列表中会显示 GACDemo 。
References
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈