Freigeben über

FileVersionInfo-Klasse

Stellt Versionsinformationen für eine physikalische Datei auf einem Datenträger bereit.

Namespace: System.Diagnostics
Assembly: System (in system.dll)

Syntax

'Declaration
Public NotInheritable Class FileVersionInfo
'Usage
Dim instance As FileVersionInfo

public sealed class FileVersionInfo

public ref class FileVersionInfo sealed

public final class FileVersionInfo

public final class FileVersionInfo

Hinweise

Eine Versionsnummer wird üblicherweise als "Hauptversionsnummer.Nebenversionsnummer.Buildnummer.Einzelteilnummer" angezeigt. Eine Dateiversionsnummer ist eine 64-Bit-Zahl, die die Versionsnummer einer Datei wie folgt enthält:

Verwenden Sie die GetVersionInfo-Methode dieser Klasse, um eine FileVersionInfo mit Informationen über eine Datei abzurufen. Informationen über die Datei finden Sie dann in den Eigenschaften. Die FileVersion-Eigenschaft stellt Versionsinformationen über die Datei bereit. Die ProductMajorPart-Eigenschaft, die ProductMinorPart-Eigenschaft, die ProductBuildPart-Eigenschaft, die ProductPrivatePart-Eigenschaft und die ProductVersion-Eigenschaft stellen Versionsinformationen für das Produkt bereit, dessen Bestandteil die angegebene Datei ist. Rufen Sie ToString auf, um eine unvollständige Liste der Eigenschaften und der zugehörigen Werte für diese Datei abzurufen.

Die FileVersionInfo-Eigenschaften beruhen auf Versionsressourceninformationen, die in die Datei integriert sind. Versionsressourcen sind häufig in Binärdateien, z. B. EXE- oder DLL-Dateien, integriert. Textdateien enthalten keine Versionsressourceninformationen.

Versionsressourcen werden i. d. R. in einer Win32-Ressourcendatei oder in Assemblyattributen angegeben. Beispielsweise gibt die IsDebug-Eigenschaft den VS_FF_DEBUG-Flagwert im VS_FIXEDFILEINFO-Block der Datei wieder, der anhand der VERSIONINFO-Ressource in einer Win32-Ressourcendatei erstellt wird. Weitere Informationen über das Angeben von Versionsressourcen in einer Win32-Ressourcendatei finden Sie in den Platform SDK-Themen "About Resource Files" und "VERSIONINFO Resource". Weitere Informationen über das Angeben von Versionsressourcen in einem .NET-Modul finden Sie im Thema Festlegen von Assemblyattributen.

Hinweis

Diese Klasse führt einen Verknüpfungsaufruf auf der Klassenebene aus, die für alle Member gilt. SecurityException wird ausgelöst, wenn der unmittelbare Aufrufer über keine Berechtigung mit vollständiger Vertrauenswürdigkeit verfügt. Ausführliche Informationen über Verknüpfungsaufrufe finden Sie unter Verknüpfungsaufrufe.

Beispiel

Im folgenden Beispiel wird GetVersionInfo aufgerufen, um FileVersionInfo für den Editor abzurufen. Die Dateibeschreibung und Versionsnummer werden dann in einem Textfeld angezeigt. Bei diesem Code wird davon ausgegangen, dass textBox1 instanziiert wurde.

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-Sicherheit

Vererbungshierarchie

System.Object
  System.Diagnostics.FileVersionInfo

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

FileVersionInfo-Member
System.Diagnostics-Namespace
FileVersion
Version

  • Last updated on