FileVersionInfo Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit des informations sur la version d'un fichier physique figurant sur le disque.
public ref class FileVersionInfo sealed
public sealed class FileVersionInfo
type FileVersionInfo = class
Public NotInheritable Class FileVersionInfo
- Héritage
-
FileVersionInfo
Exemples
L’exemple suivant appelle GetVersionInfo pour obtenir le FileVersionInfo pour le Bloc-notes. Ensuite, il imprime la description et le numéro de version du fichier dans la console.
#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
Remarques
En règle générale, un numéro de version s’affiche sous la forme « numéro principal.minor number.build number.private part number ». Un numéro de version de fichier est un numéro 64 bits qui contient le numéro de version d’un fichier comme suit :
Les 16 premiers bits sont le FileMajorPart nombre.
Les 16 bits suivants sont le FileMinorPart nombre.
Le troisième ensemble de 16 bits est le FileBuildPart nombre.
Les 16 derniers bits sont le FilePrivatePart nombre.
Utilisez la GetVersionInfo méthode de cette classe pour obtenir un contenant des FileVersionInfo informations sur un fichier, puis examinez les propriétés pour obtenir des informations sur le fichier. La FileVersion propriété fournit des informations de version sur le fichier. Les ProductMajorPartpropriétés , ProductMinorPart, ProductBuildPart, ProductPrivatePartet ProductVersion fournissent des informations de version pour le produit dont le fichier spécifié fait partie. Appelez ToString pour obtenir une liste partielle des propriétés et de leurs valeurs pour ce fichier.
Les FileVersionInfo propriétés sont basées sur les informations de ressource de version intégrées dans le fichier. Les ressources de version sont souvent intégrées dans des fichiers binaires tels que des fichiers .exe ou .dll ; les fichiers texte n’ont pas d’informations sur les ressources de version.
Les ressources de version sont généralement spécifiées dans un fichier de ressources Win32 ou dans des attributs d’assembly. Par exemple, la IsDebug propriété reflète la valeur de l’indicateur VS_FF_DEBUG
dans le bloc du VS_FIXEDFILEINFO
fichier, qui est généré à partir de la VERSIONINFO
ressource dans un fichier de ressources Win32. Pour plus d’informations sur la spécification de ressources de version dans un fichier de ressources Win32, consultez « À propos des fichiers de ressources » et « RESSOURCE VERSIONINFO » dans le Kit de développement logiciel (SDK) de plateforme. Pour plus d’informations sur la spécification des ressources de version dans un module .NET, consultez la rubrique Définition des attributs d’assembly .
Notes
Cette classe effectue une demande de liaison au niveau de la classe qui s’applique à tous les membres. Un SecurityException est levée lorsque l’appelant immédiat n’a pas l’autorisation d’approbation totale. Pour plus d’informations sur les demandes de liens, consultez Demandes de lien.
Propriétés
Comments |
Obtient les commentaires associés au fichier. |
CompanyName |
Obtient le nom de la société ayant créé le fichier. |
FileBuildPart |
Obtient le numéro de build du fichier. |
FileDescription |
Obtient la description du fichier. |
FileMajorPart |
Obtient la partie principale du numéro de version. |
FileMinorPart |
Obtient la partie secondaire du numéro de version du fichier. |
FileName |
Obtient le nom du fichier décrit par cette instance de FileVersionInfo. |
FilePrivatePart |
Obtient le numéro de référence privé du fichier. |
FileVersion |
Obtient le numéro de version du fichier. |
InternalName |
Obtient le nom interne du fichier, s'il en existe un. |
IsDebug |
Obtient une valeur qui spécifie si le fichier comporte des informations de débogage ou s’il est compilé avec les fonctionnalités de débogage activées. |
IsPatched |
Obtient une valeur qui spécifie si le fichier a été modifié et ne correspond plus au fichier d'origine portant le même numéro de version. |
IsPreRelease |
Obtient une valeur qui spécifie si le fichier correspond à une version de développement plutôt qu’à une version commercialisée. |
IsPrivateBuild |
Obtient une valeur qui spécifie si le fichier a été généré à l’aide de procédures standard. |
IsSpecialBuild |
Obtient une valeur qui spécifie si le fichier correspond à une version spéciale. |
Language |
Obtient la chaîne de langue par défaut pour le bloc d'informations sur la version. |
LegalCopyright |
Obtient toutes les mentions de droits d'auteur s'appliquant au fichier spécifié. |
LegalTrademarks |
Obtient les marques et les marques déposées s'appliquant au fichier. |
OriginalFilename |
Obtient le nom attribué au fichier à sa création. |
PrivateBuild |
Obtient des informations sur une version privée du fichier. |
ProductBuildPart |
Obtient le numéro de build du produit auquel ce fichier est associé. |
ProductMajorPart |
Obtient la partie principale du numéro de version du produit auquel ce fichier est associé. |
ProductMinorPart |
Obtient la partie secondaire du numéro de version du produit auquel le fichier est associé. |
ProductName |
Obtient le nom du produit avec lequel ce fichier est distribué. |
ProductPrivatePart |
Obtient le numéro de référence privé du produit auquel ce fichier est associé. |
ProductVersion |
Obtient la version du produit avec laquelle ce fichier est distribué. |
SpecialBuild |
Obtient des informations sur la version spéciale du fichier. |
Méthodes
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
GetVersionInfo(String) |
Retourne FileVersionInfo qui représente les informations de version associées au fichier spécifié. |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
ToString() |
Retourne une liste partielle des propriétés dans FileVersionInfo, ainsi que leurs valeurs. |