FileVersionInfo 类

为磁盘上的物理文件提供版本信息。

**命名空间:**System.Diagnostics
**程序集:**System（在 system.dll 中）

语法

声明
Public NotInheritable Class FileVersionInfo
用法
Dim instance As FileVersionInfo

public sealed class FileVersionInfo

public ref class FileVersionInfo sealed

public final class FileVersionInfo

public final class FileVersionInfo

备注

通常，版本号显示为“主版本号.次版本号.内部版本号.专用部件号”。文件版本号是一个 64 位的数字，它按如下形式表示文件的版本号：

• 前 16 位是 FileMajorPart 编号。

• 第二组 16 位是 FileMinorPart 编号。

• 第三组 16 位是 FileBuildPart 编号。

• 最后 16 位是 FilePrivatePart 编号。

使用此类的 GetVersionInfo 方法获取包含文件信息的 FileVersionInfo，然后在属性中查找文件信息。FileVersion 属性提供文件的版本信息。ProductMajorPart、 ProductMinorPart、ProductBuildPart、ProductPrivatePart 和 ProductVersion 属性提供指定文件所属的产品的版本信息。调用 ToString 以获取该文件的属性及相应值的部分列表。

FileVersionInfo 属性基于该文件中内置的版本资源信息。版本资源通常内置在二进制文件（如 .exe 或 .dll 文件）中；文本文件不具有版本资源信息。

版本资源通常在 Win32 资源文件中或在程序集属性中指定。例如，IsDebug 属性反映文件 VS_FIXEDFILEINFO 块中的 VS_FF_DEBUG 标志值，这个块根据 Win32 资源文件中的 VERSIONINFO 资源生成。有关在 Win32 资源文件中指定版本资源的更多信息，请参见 Platform SDK 中的“关于资源文件”和“VERSIONINFO 资源”。有关在 .NET 模块中指定版本资源的更多信息，请参见设置程序集属性主题。

提示

此类在类级别上有一个要应用于所有成员的链接要求。直接调用方不具有完全信任权限时，将引发 SecurityException。有关链接要求的详细信息，请参见 链接要求。

示例

下面的示例调用 GetVersionInfo 来获取“记事本”(Notepad) 的 FileVersionInfo。然后，它在文本框内输出文件说明和版本号。这段代码假定已经实例化 textBox1。

Sub GetFileVersion()
    ' Get the file version for the notepad.
    Dim myFileVersionInfo As FileVersionInfo = FileVersionInfo.GetVersionInfo("%systemroot%\Notepad.exe")
    
    ' Print the file name and version number.
    textBox1.Text = "File: " & myFileVersionInfo.FileDescription & ControlChars.Cr & _
        "Version number: " & myFileVersionInfo.FileVersion
End Sub 'GetFileVersion

public void GetFileVersion() {
    // Get the file version for the notepad.
    FileVersionInfo myFileVersionInfo = FileVersionInfo.GetVersionInfo("%systemroot%\\Notepad.exe");
 
    // Print the file name and version number.
    textBox1.Text = "File: " + myFileVersionInfo.FileDescription + '\n' +
       "Version number: " + myFileVersionInfo.FileVersion;
 }
    

public:
   [PermissionSet(SecurityAction::Demand, Name="FullTrust")]
   void GetFileVersion()
   {
      // Get the file version for the notepad.
      FileVersionInfo^ myFileVersionInfo = FileVersionInfo::GetVersionInfo( "%systemroot%\\Notepad.exe" );
      
      // Print the file name and version number.
      textBox1->Text = String::Concat( "File: " + myFileVersionInfo->FileDescription + "\n" +
         "Version number: " + myFileVersionInfo->FileVersion );
   }

.NET Framework 安全性

• SecurityPermission  用于调用 FileVersionInfo 的成员。要求值：LinkDemand；命名的权限集：FullTrust。

继承层次结构

System.Object
  System.Diagnostics.FileVersionInfo

线程安全

此类型的任何公共静态（Visual Basic 中的 Shared）成员都是线程安全的，但不保证所有实例成员都是线程安全的。

平台

Windows 98、Windows 2000 SP4、Windows Millennium Edition、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

请参见

参考

FileVersionInfo 成员
System.Diagnostics 命名空间
FileVersion
Version