2.5 程序集版本资源信息

时间:2021-12-10 03:06:50

  AL.exe或CSC.exe生成一个PE文件程序集时,还会在PE文件中嵌入一个标准的Win32版本资源。用户可以查看文件的属性来检查这个资源。在应用程序代码中,可以调用System.Diagnostics.FileVersionInfo的static方法GetVersionInfo来获取并检查这些信息。图2-4显示的是JeffType.dll属性对话框的“详细信息”选项卡。

2.5 程序集版本资源信息

图2-4 “JeffTypes.dll属性”对话框的“详细信息”选项卡

  生成程序集时,应该使用一些定制attribute来设置版本资源文件,这些attribute是在源代码中应用于assembly这一级别的。图2-4的版本信息是用以下代码来生成的:

using System.Reflection;

//  FileDescription版本信息
[assembly:AssemblyTitle("JeffTypes.dll")]

//  Comments版本信息
[assembly:AssemblyDescription("This assembly contains Jeff's types")]

//  CompandName版本信息
[assembly:AssemblyCompany("Wintellect")]

//  ProdutctName版本信息
[assembly:AssemblyProduct("Wintellect (R) Jeff's Type Library")]

//  LegalCopyright版本信息
[assembly:AssemblyCopyright("Copyright (c) Wintellect 2010")]

//  LegalTrademarks版本信息
[assembly:AssemblyTrademark("JeffTypes is a registered trademark of Wintellect")]

//  AssemblyVersion版本信息
[assembly:AssemblyVersion("3.0.0.0")]

//  FILEVERSION/FileVersion版本信息
[assembly:AssemblyFileVersion("1.0.0.0")]

//  PRODUCTVERSION/ProductVersion版本信息
[assembly:AssemblyInformationalVersion("2.0.0.0")]

//  设置Language字段(参见2.6节“语言文化”)
[assembly:AssemblyCulture("")]

重要提示:Windows资源管理器的属性对话框明显遗漏了一些attribute值。最遗憾的是没有显示AssemblyVersion这个attribute值,因为CLR加载程序集时会使用这个值,详情将在第3章讨论。

  表2-4总结了版本资源字段以及它们对应的定制attribute。如果使用AL.exe来生成程序集,可以用命令行开关来设置这些信息,而不必使用定制attribute。表2-4的第二列显示了每个版本资源字段对应的AL.exe命令行开关。注意,C#编译器没有提供这些命令行开关。在这种情况下,最好是用定制attribute来设置这些信息。

  表2-4 版本资源字段和对应的AL.exe开关/定制attribute

版本资源 AL.exe开关 定制attribute/说明
FILEVERSION /fileversion System.Reflection.AssemblyFileVersionAttribute
PRODUCTVERSION /productversion System.Reflection.AssemblyInformationalVersionAttribute
FILEFLAGSMASK (无) 总是设为VS_FFI_FILEFLAGSMASK(在WinVer.h中定义为0x0000003F)
FILEFLAGS (无) 总是0
FILEOS (无) 目前总是VOS__WINDOWS32
FILETYPE /target 如果指定了/target:exe/target:winexe,就设为VFT_APP;如果指定了/target:library,就设为VFT_DLL
FILESUBTYPE (无) 总是设为VFT2_UNKNOWN(该字段对于VFT_APPVFT_DLL无意义)
AssemblyVersion /version System.Reflection.AssemblyVersionAttribute
Comments /description System.Reflection.AssemblyDescriptionAttribute
CompanyName /company System.Reflection.AssemblyCompanyAttribute
FileDescription /title System.Reflection.AssemblyTitleAttribute
FileVersion /version System.Reflection.AssemblyFileVersionAttribute
InternalName /out 设为指定的输出文件的名称(无扩展名)
LegalCopyright /copyright System.Reflection.AssemblyCopyrightAttribute
LegalTrademarks /trademark System.Reflection.AssemblyTrademarkAttribute
OriginalFilename /out 设为输出文件的名称(无路径)
PrivateBuild (无) 总是为空
ProductName /product System.Reflection.AssemblyProductAttribute
ProductVersion /productversion System.Reflection.AssemblyInformationalVersionAttribute
SpecialBuild (无) 总是空白

重要提示:在Visual Studio中新建一个C#项目时,会自动创建一个AssemblyInfo.cs文件。这个文件除了包含本节描述的所有程序集版本attribute之外,还包括要在第3章讨论的几个attribute。可直接打开AssemblyInfo.cs文件,并修改你的程序集特有的信息。Visual Studio还提供了一个对话框来帮助你编辑这个文件中的程序集信息。为了打开这个对话框,请打开项目的属性对话框,然后在“应用程序”选项卡中单击“程序集信息”。随后会看到如图2-5所示的一个对话框。

2.5 程序集版本资源信息

图2-5 Visual Studio的“程序集信息”对话框

 

  返回目录