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 bloco de notas. Em seguida, ele imprime a descrição do arquivo e o número de versão no console.
using System;
using System.IO;
using System.Diagnostics;
class Class1
{
public static void Main(string[] args)
{
// Get the file version for the notepad.
FileVersionInfo myFileVersionInfo = FileVersionInfo.GetVersionInfo(Path.Combine(Environment.SystemDirectory, "Notepad.exe"));
// Print the file name and version number.
Console.WriteLine("File: " + myFileVersionInfo.FileDescription + Environment.NewLine +
"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.
Dim myFileVersionInfo As FileVersionInfo = FileVersionInfo.GetVersionInfo(Path.Combine(Environment.SystemDirectory, "Notepad.exe"))
' Print the file name and version number.
Console.WriteLine("File: " + myFileVersionInfo.FileDescription + Environment.NewLine + "Version number: " + myFileVersionInfo.FileVersion)
End Sub
End Class
Comentários
Normalmente, um número de versão é exibido como "número principal.minor number.build number.private part number". 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, ProductBuildParte ProductPrivatePartProductVersion 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 este arquivo.
As FileVersionInfo propriedades são baseadas em informações de recurso de versão internas no 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, consulte "Sobre arquivos de recursos" e "Recurso VERSIONINFO" 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 De configuração de atributos de assembly .
Observação
Essa classe faz uma demanda de link no nível de 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 demandas de link, consulte Demandas de link.
Propriedades
| Nome | Description |
|---|---|
| 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 que esta instância FileVersionInfo descreve. |
| FilePrivatePart |
Obtém o número da parte privada do arquivo. |
| FileVersion |
Obtém o número da versão do arquivo. |
| InternalName |
Obtém o nome interno do arquivo, se houver um. |
| IsDebug |
Obtém um valor que especifica se o arquivo contém informações de depuração ou é compilado com 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 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 de idioma padrão para o bloco de informações de versão. |
| LegalCopyright |
Obtém todos os avisos de direitos autorais que se aplicam ao arquivo especificado. |
| LegalTrademarks |
Obtém as marcas comerciais e marcas registradas que se aplicam ao arquivo. |
| OriginalFilename |
Obtém o nome com o qual 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 ao qual este arquivo está associado. |
| ProductMajorPart |
Obtém a parte principal do número de versão do produto ao qual esse arquivo está associado. |
| ProductMinorPart |
Obtém a parte secundária do número de versão do produto ao qual o arquivo está associado. |
| ProductName |
Obtém o nome do produto com o qual este arquivo é distribuído. |
| ProductPrivatePart |
Obtém o número de parte privada do produto ao qual este arquivo está associado. |
| ProductVersion |
Obtém a versão do produto com o qual este arquivo é distribuído. |
| SpecialBuild |
Obtém as informações especiais de build para o arquivo. |
Métodos
| Nome | Description |
|---|---|
| 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 uma FileVersionInfo representação das informações de versão associadas ao arquivo especificado. |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| ToString() |
Retorna uma lista parcial de propriedades no FileVersionInfo e em seus valores. |