FileVersionInfo Classe

Referência

Definição

Namespace:: System.Diagnostics

Assembly:: System.Diagnostics.FileVersionInfo.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Origem:: FileVersionInfo.cs

Origem:: FileVersionInfo.cs

Origem:: FileVersionInfo.cs

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: Object
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.

Aplica-se a

Partilhar via