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 physikalische Datei auf einem 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 die FileVersionInfo für den Editor abzurufen. Anschließend werden die Dateibeschreibung und die Versionsnummer in der Konsole ausgegeben.
#using <System.dll>
using namespace System;
using namespace System::IO;
using namespace System::Diagnostics;
public ref class Class1
{
public:
static void Main()
{
// Get the file version for the notepad.
// Use either of the two following methods.
FileVersionInfo::GetVersionInfo(Path::Combine(Environment::SystemDirectory, "Notepad.exe"));
FileVersionInfo^ myFileVersionInfo = FileVersionInfo::GetVersionInfo(Environment::SystemDirectory + "\\Notepad.exe");
// Print the file name and version number.
Console::WriteLine("File: " + myFileVersionInfo->FileDescription + "\n" +
"Version number: " + myFileVersionInfo->FileVersion);
}
};
int main()
{
Class1::Main();
}
using System;
using System.IO;
using System.Diagnostics;
class Class1
{
public static void Main(string[] args)
{
// Get the file version for the notepad.
// Use either of the two following commands.
FileVersionInfo.GetVersionInfo(Path.Combine(Environment.SystemDirectory, "Notepad.exe"));
FileVersionInfo myFileVersionInfo = FileVersionInfo.GetVersionInfo(Environment.SystemDirectory + "\\Notepad.exe");
// Print the file name and version number.
Console.WriteLine("File: " + myFileVersionInfo.FileDescription + '\n' +
"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.
' Use either of the following two commands.
FileVersionInfo.GetVersionInfo(Path.Combine(Environment.SystemDirectory, "Notepad.exe"))
Dim myFileVersionInfo As FileVersionInfo = FileVersionInfo.GetVersionInfo(Environment.SystemDirectory + "\Notepad.exe")
' Print the file name and version number.
Console.WriteLine("File: " + myFileVersionInfo.FileDescription + vbLf + "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 sehen Sie sich dann die Eigenschaften nach Informationen zur Datei an. Die FileVersion -Eigenschaft stellt Versionsinformationen zur Datei bereit. Die ProductMajorPartEigenschaften , ProductMinorPart, ProductBuildPart, ProductPrivatePartund ProductVersion stellen Versionsinformationen für das Produkt bereit, zu dem die angegebene Datei gehört. Rufen Sie auf ToString , 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 spiegelt beispielsweise IsDebug den VS_FF_DEBUG
Flagwert im Block der Datei VS_FIXEDFILEINFO
wider, 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 Festlegen von Assemblyattributen .
Hinweis
Diese Klasse stellt eine Linkanforderungen auf Der Klassenebene, die für alle Member gilt. Ein SecurityException wird ausgelöst, wenn der unmittelbare Aufrufer nicht über die Vollvertrauensberechtigung verfügt. Ausführliche Informationen zu Linkanforderungen finden Sie unter Linkanforderungen.
Eigenschaften
Comments |
Ruft die der Datei zugeordneten Kommentare ab. |
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 zweiten Teil der Versionsnummer (Nebenversionsnummer) der Datei ab. |
FileName |
Ruft den Namen der Datei ab, die diese Instanz von FileVersionInfo beschreibt. |
FilePrivatePart |
Ruft die Einzelteilnummer der Datei ab. |
FileVersion |
Ruft die Versionsnummer der Datei ab. |
InternalName |
Ruft den internen Namen der Datei ab, sofern vorhanden. |
IsDebug |
Ruft einen Wert ab, der angibt, ob die Datei Debuginformationen enthält oder mit aktivierten Debugfunktionen kompiliert wurde. |
IsPatched |
Ruft einen Wert ab, der angibt, ob die Datei geändert wurde und von der Originaldatei mit derselben Versionsnummer abweicht. |
IsPreRelease |
Ruft einen Wert ab, der angibt, ob die Datei eine Entwicklungsversion und kein kommerziell vertriebenes Produkt ist. |
IsPrivateBuild |
Ruft einen Wert ab, der angibt, ob die Datei mithilfe von Standardverfahren zum Release erstellt wurde. |
IsSpecialBuild |
Ruft einen Wert ab, der angibt, ob die Datei ein besonderes Build ist. |
Language |
Ruft die Zeichenfolge der Standardsprache für den Versionsinformationsblock ab. |
LegalCopyright |
Ruft alle Copyrighthinweise ab, die für die angegebene Datei gültig sind. |
LegalTrademarks |
Ruft die Marken und eingetragenen Marken ab, die die Datei betreffen. |
OriginalFilename |
Ruft den Namen ab, mit dem die Datei erstellt wurde. |
PrivateBuild |
Ruft Informationen über eine private Version der Datei ab. |
ProductBuildPart |
Ruft die Buildnummer des Produkts ab, dem diese Datei zugeordnet ist. |
ProductMajorPart |
Ruft den Hauptteil der Versionsnummer des Produkts ab, dem diese Datei zugeordnet ist. |
ProductMinorPart |
Ruft den zweiten Teil der Versionsnummer (Nebenversionsnummer) des Produkts ab, dem diese Datei zugeordnet ist. |
ProductName |
Ruft den Namen des Produkts ab, mit dem diese Datei geliefert wird. |
ProductPrivatePart |
Ruft die Einzelteilnummer des Produkts ab, dem diese Datei zugeordnet ist. |
ProductVersion |
Ruft die Version des Produkts ab, mit dem diese Datei geliefert wird. |
SpecialBuild |
Ruft die Informationen über das besondere Build für die Datei ab. |
Methoden
Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
GetVersionInfo(String) |
Gibt eine FileVersionInfo zurück, die die Versionsinformationen darstellt, die der angegebenen Datei zugeordnet sind. |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
ToString() |
Gibt eine unvollständige Liste der Eigenschaften in FileVersionInfo und deren Werte zurück. |