FileVersionInfo Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece informações de versão para um arquivo físico no disco.
public ref class FileVersionInfo sealed
public sealed class FileVersionInfo
type FileVersionInfo = class
Public NotInheritable Class FileVersionInfo
- Herança
-
FileVersionInfo
Exemplos
O exemplo a seguir chama GetVersionInfo para obter o FileVersionInfo para o Bloco de Notas. Em seguida, ele imprime a descrição do arquivo e o número de versão no 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
Comentários
Normalmente, um número de versão é exibido como "número principal.número secundário.número de build.número de parte privada". Um número de versão do arquivo é um número de 64 bits que contém o número de versão de um arquivo da seguinte maneira:
Os primeiros 16 bits são o FileMajorPart número.
Os próximos 16 bits são o FileMinorPart número.
O terceiro conjunto de 16 bits é o FileBuildPart número.
Os últimos 16 bits são o FilePrivatePart número.
Use o GetVersionInfo método dessa classe para obter informações FileVersionInfo sobre um arquivo e, em seguida, examine as propriedades para obter informações sobre o arquivo. A FileVersion propriedade fornece informações de versão sobre o arquivo. As ProductMajorPartpropriedades , ProductMinorPart, ProductBuildPart, ProductPrivateParte ProductVersion fornecem informações de versão para o produto do qual o arquivo especificado faz parte. Chame ToString para obter uma lista parcial de propriedades e seus valores para esse arquivo.
As FileVersionInfo propriedades são baseadas em informações de recurso de versão incorporadas ao arquivo. Os recursos de versão geralmente são incorporados em arquivos binários, como arquivos .exe ou .dll; os arquivos de texto não têm informações de recurso de versão.
Os recursos de versão normalmente são especificados em um arquivo de recurso Win32 ou em atributos de assembly. Por exemplo, a IsDebug propriedade reflete o VS_FF_DEBUG
valor do sinalizador no bloco do VS_FIXEDFILEINFO
arquivo, que é criado a partir do VERSIONINFO
recurso em um arquivo de recurso Win32. Para obter mais informações sobre como especificar recursos de versão em um arquivo de recurso do Win32, confira "Sobre arquivos de recurso" e "VERSIONINFO Resource" no SDK da plataforma. Para obter mais informações sobre como especificar recursos de versão em um módulo .NET, consulte o tópico Definindo atributos de assembly.
Observação
Essa classe faz uma demanda de link no nível da classe que se aplica a todos os membros. Um SecurityException é gerado quando o chamador imediato não tem permissão de confiança total. Para obter detalhes sobre as demandas de link, consulte Vincular demandas.
Propriedades
Comments |
Obtém os comentários associados ao arquivo. |
CompanyName |
Obtém o nome da empresa que produziu o arquivo. |
FileBuildPart |
Obtém o número de build do arquivo. |
FileDescription |
Obtém a descrição do arquivo. |
FileMajorPart |
Obtém a parte principal do número de versão. |
FileMinorPart |
Obtém a parte secundária do número de versão do arquivo. |
FileName |
Obtém o nome do arquivo descrito por esta instância de FileVersionInfo. |
FilePrivatePart |
Obtém o número de peça particular do arquivo. |
FileVersion |
Obtém o número de versão do arquivo. |
InternalName |
Obtém o nome interno do arquivo, se houver. |
IsDebug |
Obtém um valor que especifica se o arquivo contém informações de depuração ou é compilado com os recursos de depuração habilitados. |
IsPatched |
Obtém um valor que especifica se o arquivo foi modificado e não é idêntico ao arquivo de envio original do mesmo número de versão. |
IsPreRelease |
Obtém um valor que especifica se o arquivo é uma versão de desenvolvimento, em vez de um produto lançado comercialmente. |
IsPrivateBuild |
Obtém um valor que especifica se o arquivo foi criado usando os procedimentos de versão padrão. |
IsSpecialBuild |
Obtém um valor que especifica se o arquivo é um build especial. |
Language |
Obtém a cadeia de caracteres do idioma padrão para o bloco de informações de versão. |
LegalCopyright |
Obtém todos os avisos de direitos autorais aplicáveis ao arquivo especificado. |
LegalTrademarks |
Obtém as marcas e marcas registradas que se aplicam ao arquivo. |
OriginalFilename |
Obtém o nome com que o arquivo foi criado. |
PrivateBuild |
Obtém informações sobre uma versão privada do arquivo. |
ProductBuildPart |
Obtém o número de build do produto com o qual esse arquivo está associado. |
ProductMajorPart |
Obtém a parte principal do número de versão do produto com o qual esse arquivo está associado. |
ProductMinorPart |
Obtém a parte secundária do número de versão do produto com o qual o arquivo está associado. |
ProductName |
Obtém o nome do produto com o qual esse arquivo é distribuído. |
ProductPrivatePart |
Obtém o número da parte privada do produto com o qual esse arquivo está associado. |
ProductVersion |
Obtém a versão do produto com que este arquivo é distribuído. |
SpecialBuild |
Obtém as informações de build especiais para o arquivo. |
Métodos
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
GetHashCode() |
Serve como a função de hash padrão. (Herdado de Object) |
GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
GetVersionInfo(String) |
Retorna um FileVersionInfo que representa as informações de versão associadas ao arquivo especificado. |
MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
ToString() |
Retorna uma lista parcial das propriedades no FileVersionInfo e dos respectivos valores. |