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 aufgerufenGetVersionInfo, um die FileVersionInfo Editor abzurufen. Anschließend wird die Dateibeschreibung und Versionsnummer in der Konsole gedruckt.
#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 "hauptnummer.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 Nummer.
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 eine FileVersionInfo enthaltende Informationen zu einer Datei abzurufen, und schauen Sie sich dann die Eigenschaften für Informationen zur Datei an. Die FileVersion Eigenschaft enthält Versionsinformationen zur Datei. Die ProductMajorPart, ProductMinorPartProductBuildPartProductPrivatePartund ProductVersion Eigenschaften stellen Versionsinformationen für das Produkt bereit, von dem die angegebene Datei teil ist. 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 Kennzeichenwert 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 " Assemblyattribute festlegen ".
Hinweis
Diese Klasse macht eine Linknachfrage auf Klassenebene, die für alle Mitglieder gilt. Ein SecurityException Wird ausgelöst, wenn der sofortige Anrufer keine voll vertrauenswürdige Berechtigung hat. 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. |