FileVersionInfo Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt Versionsinformationen für eine physische Datei auf dem Datenträger bereit.
public ref class FileVersionInfo sealed
public sealed class FileVersionInfo
type FileVersionInfo = class
Public NotInheritable Class FileVersionInfo
- Vererbung
-
FileVersionInfo
Beispiele
Im folgenden Beispiel wird aufgerufen GetVersionInfo , um das FileVersionInfo Editor-Steuerelement abzurufen. Anschließend wird die Dateibeschreibung und versionsnummer in der Konsole gedruckt.
using System;
using System.IO;
using System.Diagnostics;
class Class1
{
public static void Main(string[] args)
{
// Get the file version for the notepad.
FileVersionInfo myFileVersionInfo = FileVersionInfo.GetVersionInfo(Path.Combine(Environment.SystemDirectory, "Notepad.exe"));
// Print the file name and version number.
Console.WriteLine("File: " + myFileVersionInfo.FileDescription + Environment.NewLine +
"Version number: " + myFileVersionInfo.FileVersion);
}
}
Imports System.IO
Imports System.Diagnostics
Class Class1
Public Shared Sub Main(ByVal args() As String)
' Get the file version for the notepad.
Dim myFileVersionInfo As FileVersionInfo = FileVersionInfo.GetVersionInfo(Path.Combine(Environment.SystemDirectory, "Notepad.exe"))
' Print the file name and version number.
Console.WriteLine("File: " + myFileVersionInfo.FileDescription + Environment.NewLine + "Version number: " + myFileVersionInfo.FileVersion)
End Sub
End Class
Hinweise
In der Regel wird eine Versionsnummer als "Major number.minor number.build number.private part number" angezeigt. Eine Dateiversionsnummer ist eine 64-Bit-Nummer, die die Versionsnummer für eine Datei wie folgt enthält:
Die ersten 16 Bits sind die FileMajorPart Zahl.
Die nächsten 16 Bits sind die FileMinorPart Zahl.
Der dritte Satz von 16 Bits ist die FileBuildPart Zahl.
Die letzten 16 Bits sind die FilePrivatePart Zahl.
Verwenden Sie die GetVersionInfo Methode dieser Klasse, um informationen FileVersionInfo zu einer Datei abzurufen, und schauen Sie sich dann die Eigenschaften an, um Informationen zur Datei zu erhalten. Die FileVersion Eigenschaft enthält Versionsinformationen zur Datei. Die ProductMajorPart, ProductMinorPart, ProductBuildPart, ProductPrivatePartund ProductVersion Eigenschaften stellen Versionsinformationen für das Produkt bereit, in dem die angegebene Datei Teil ist. Rufen Sie ToString auf, um eine partielle Liste der Eigenschaften und deren Werte für diese Datei abzurufen.
Die FileVersionInfo Eigenschaften basieren auf Versionsressourceninformationen, die in die Datei integriert sind. Versionsressourcen sind häufig in Binärdateien wie .exe oder .dll Dateien integriert. Textdateien verfügen nicht über Versionsressourceninformationen.
Versionsressourcen werden in der Regel in einer Win32-Ressourcendatei oder in Assemblyattributen angegeben. Die Eigenschaft gibt z. B IsDebug . den VS_FF_DEBUG Flagwert im Block der Datei VS_FIXEDFILEINFO wieder, der aus der VERSIONINFO Ressource in einer Win32-Ressourcendatei erstellt wird. Weitere Informationen zum Angeben von Versionsressourcen in einer Win32-Ressourcendatei finden Sie unter "Informationen zu Ressourcendateien" und "VERSIONINFO-Ressource" im Platform SDK. Weitere Informationen zum Angeben von Versionsressourcen in einem .NET-Modul finden Sie im Thema zum Festlegen von Assemblyattributen .
Hinweis
Diese Klasse macht eine Verknüpfungsnachfrage auf Klassenebene, die für alle Member gilt. Ein SecurityException Fehler wird ausgelöst, wenn der sofortige Aufrufer nicht über voll vertrauenswürdige Berechtigungen verfügt. Ausführliche Informationen zu Linkanforderungen finden Sie unter Linkanforderungen.
Eigenschaften
| Name | Beschreibung |
|---|---|
| Comments |
Ruft die Kommentare ab, die der Datei zugeordnet sind. |
| CompanyName |
Ruft den Namen des Unternehmens ab, das die Datei erstellt hat. |
| FileBuildPart |
Ruft die Buildnummer der Datei ab. |
| FileDescription |
Ruft die Beschreibung der Datei ab. |
| FileMajorPart |
Ruft den Hauptteil der Versionsnummer ab. |
| FileMinorPart |
Ruft den Nebenteil der Versionsnummer der Datei ab. |
| FileName |
Ruft den Namen der Datei ab, die FileVersionInfo in dieser Instanz beschrieben wird. |
| FilePrivatePart |
Ruft die Private Part-Nummer der Datei ab. |
| FileVersion |
Ruft die Dateiversionsnummer ab. |
| InternalName |
Ruft den internen Namen der Datei ab, falls vorhanden. |
| IsDebug |
Ruft einen Wert ab, der angibt, ob die Datei Debuginformationen enthält oder mit aktivierten Debugfeatures kompiliert wird. |
| IsPatched |
Ruft einen Wert ab, der angibt, ob die Datei geändert wurde und nicht mit der ursprünglichen Versanddatei derselben Versionsnummer identisch ist. |
| IsPreRelease |
Ruft einen Wert ab, der angibt, ob es sich bei der Datei um eine Entwicklungsversion und nicht um ein kommerziell veröffentlichtes Produkt handelt. |
| IsPrivateBuild |
Ruft einen Wert ab, der angibt, ob die Datei mithilfe von Standardveröffentlichungsverfahren erstellt wurde. |
| IsSpecialBuild |
Ruft einen Wert ab, der angibt, ob die Datei ein spezieller Build ist. |
| Language |
Ruft die Standardsprachenzeichenfolge für den Versionsinformationsblock ab. |
| LegalCopyright |
Ruft alle Copyright-Hinweise ab, die für die angegebene Datei gelten. |
| LegalTrademarks |
Ruft die Marken und registrierten Marken ab, die für die Datei gelten. |
| OriginalFilename |
Ruft den Namen ab, mit dem die Datei erstellt wurde. |
| PrivateBuild |
Ruft Informationen zu einer privaten Version der Datei ab. |
| ProductBuildPart |
Ruft die Buildnummer des Produkts ab, dem diese Datei zugeordnet ist. |
| ProductMajorPart |
Ruft den Hauptteil der Versionsnummer für das Produkt ab, dem diese Datei zugeordnet ist. |
| ProductMinorPart |
Ruft den Nebenteil der Versionsnummer für das Produkt ab, dem die Datei zugeordnet ist. |
| ProductName |
Ruft den Namen des Produkts ab, mit dem diese Datei verteilt wird. |
| ProductPrivatePart |
Ruft die private Teilenummer des Produkts ab, dem diese Datei zugeordnet ist. |
| ProductVersion |
Ruft die Version des Produkts ab, mit dem diese Datei verteilt wird. |
| SpecialBuild |
Ruft die speziellen Buildinformationen für die Datei ab. |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| GetVersionInfo(String) |
Gibt eine FileVersionInfo Darstellung der Versionsinformationen zurück, die der angegebenen Datei zugeordnet sind. |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine partielle Liste der Eigenschaften in den FileVersionInfo und deren Werten zurück. |