FileVersionInfo Class

Definition

Proporciona información de versión para un archivo físico en disco.Provides version information for a physical file on disk.

public ref class FileVersionInfo sealed
public sealed class FileVersionInfo
type FileVersionInfo = class
Public NotInheritable Class FileVersionInfo
Inheritance
FileVersionInfo

Examples

En el ejemplo siguiente se llama a GetVersionInfo para obtener el FileVersionInfo para el Bloc de notas.The following example calls GetVersionInfo to get the FileVersionInfo for the Notepad. A continuación, imprime la descripción del archivo y el número de versión en la consola.Then it prints the file description and version number to the 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

Remarks

Normalmente, un número de versión se muestra como "número principal. número secundario. número de compilación. número de pieza privada".Typically, a version number is displayed as "major number.minor number.build number.private part number". Un número de versión de archivo es un número de 64 bits que contiene el número de versión de un archivo como se indica a continuación:A file version number is a 64-bit number that holds the version number for a file as follows:

Use el método GetVersionInfo de esta clase para obtener un FileVersionInfo que contenga información sobre un archivo y, a continuación, examine las propiedades para obtener información sobre el archivo.Use the GetVersionInfo method of this class to get a FileVersionInfo containing information about a file, then look at the properties for information about the file. La propiedad FileVersion proporciona información de versión sobre el archivo.The FileVersion property provides version information about the file. Las propiedades ProductMajorPart, ProductMinorPart, ProductBuildPart, ProductPrivateParty ProductVersion proporcionan información de versión del producto del que forma parte el archivo especificado.The ProductMajorPart, ProductMinorPart, ProductBuildPart, ProductPrivatePart, and ProductVersion properties provide version information for the product that the specified file is a part of. Llame a ToString para obtener una lista parcial de propiedades y sus valores para este archivo.Call ToString to get a partial list of properties and their values for this file.

Las propiedades de FileVersionInfo se basan en la información de recursos de versión integrada en el archivo.The FileVersionInfo properties are based on version resource information built into the file. Los recursos de versión suelen estar integrados en archivos binarios como archivos. exe o. dll; los archivos de texto no tienen información de recursos de versión.Version resources are often built into binary files such as .exe or .dll files; text files do not have version resource information.

Los recursos de versión se especifican normalmente en un archivo de recursos de Win32 o en atributos de ensamblado.Version resources are typically specified in a Win32 resource file, or in assembly attributes. Por ejemplo, la propiedad IsDebug refleja el valor de marca de VS_FF_DEBUG en el bloque de VS_FIXEDFILEINFO del archivo, que se genera a partir del recurso de VERSIONINFO en un archivo de recursos de Win32.For example the IsDebug property reflects the VS_FF_DEBUG flag value in the file's VS_FIXEDFILEINFO block, which is built from the VERSIONINFO resource in a Win32 resource file. Para obtener más información sobre cómo especificar recursos de versión en un archivo de recursos de Win32, vea "About Resource Files" y "VERSIONINFO Resource" en Platform SDK.For more information about specifying version resources in a Win32 resource file, see "About Resource Files" and "VERSIONINFO Resource" in the Platform SDK. Para obtener más información sobre cómo especificar recursos de versión en un módulo de .NET, consulte el tema configuración de atributos de ensamblado .For more information about specifying version resources in a .NET module, see the Setting Assembly Attributes topic.

Note

Esta clase realiza una petición de vínculo en el nivel de clase que se aplica a todos los miembros.This class makes a link demand at the class level that applies to all members. Se produce una SecurityException cuando el llamador inmediato no tiene permiso de plena confianza.A SecurityException is thrown when the immediate caller does not have full trust permission. Para obtener más información sobre las peticiones de vínculo, vea peticiones de vínculo.For details about link demands, see Link Demands.

Properties

Comments

Obtiene los comentarios asociados al archivo.Gets the comments associated with the file.

CompanyName

Obtiene el nombre de la compañía que creó el archivo.Gets the name of the company that produced the file.

FileBuildPart

Obtiene el número de compilación del archivo.Gets the build number of the file.

FileDescription

Obtiene una descripción del archivo.Gets the description of the file.

FileMajorPart

Obtiene la parte principal del número de versión.Gets the major part of the version number.

FileMinorPart

Obtiene la parte secundaria del número de versión del archivo.Gets the minor part of the version number of the file.

FileName

Obtiene el nombre del archivo descrito por esta instancia de FileVersionInfo.Gets the name of the file that this instance of FileVersionInfo describes.

FilePrivatePart

Obtiene el número de la parte privada del archivo.Gets the file private part number.

FileVersion

Obtiene el número de versión del archivo.Gets the file version number.

InternalName

Obtiene el nombre interno del archivo, en caso de que exista.Gets the internal name of the file, if one exists.

IsDebug

Obtiene un valor que especifica si el archivo contiene información de depuración o se compila con las características de depuración habilitadas.Gets a value that specifies whether the file contains debugging information or is compiled with debugging features enabled.

IsPatched

Obtiene un valor que especifica si el archivo se ha modificado y no es idéntico al archivo suministrado originalmente con el mismo número de versión.Gets a value that specifies whether the file has been modified and is not identical to the original shipping file of the same version number.

IsPreRelease

Obtiene un valor que especifica si el archivo pertenece a una versión de desarrollo, no a una versión comercial del producto.Gets a value that specifies whether the file is a development version, rather than a commercially released product.

IsPrivateBuild

Obtiene un valor que especifica si el archivo se compiló mediante procedimientos estándar para versiones de lanzamiento.Gets a value that specifies whether the file was built using standard release procedures.

IsSpecialBuild

Obtiene un valor que especifica si el archivo pertenece a una versión de compilación especial.Gets a value that specifies whether the file is a special build.

Language

Obtiene la cadena de idioma predeterminada para el bloque de información de versión.Gets the default language string for the version info block.

LegalCopyright

Obtiene todos los avisos de copyright que se aplican al archivo especificado.Gets all copyright notices that apply to the specified file.

LegalTrademarks

Obtiene las marcas comerciales y marcas registradas que se aplican al archivo.Gets the trademarks and registered trademarks that apply to the file.

OriginalFilename

Obtiene el nombre con el que se creó el archivo.Gets the name the file was created with.

PrivateBuild

Obtiene información sobre una versión privada del archivo.Gets information about a private version of the file.

ProductBuildPart

Obtiene el número de compilación del producto al que está asociado este archivo.Gets the build number of the product this file is associated with.

ProductMajorPart

Obtiene la parte principal del número de versión del producto al que está asociado este archivo.Gets the major part of the version number for the product this file is associated with.

ProductMinorPart

Obtiene la parte secundaria del número de versión del producto al que está asociado el archivo.Gets the minor part of the version number for the product the file is associated with.

ProductName

Obtiene el nombre del producto con el que se distribuye este archivo.Gets the name of the product this file is distributed with.

ProductPrivatePart

Obtiene el número de parte privada del producto al que está asociado este archivo.Gets the private part number of the product this file is associated with.

ProductVersion

Obtiene la versión del producto con la que se distribuye este archivo.Gets the version of the product this file is distributed with.

SpecialBuild

Obtiene la información de compilación especial para el archivo.Gets the special build information for the file.

Methods

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
GetVersionInfo(String)

Devuelve un objeto FileVersionInfo que representa la información de versión asociada al archivo especificado.Returns a FileVersionInfo representing the version information associated with the specified file.

MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Devuelve una lista parcial de propiedades de FileVersionInfo y sus valores.Returns a partial list of properties in the FileVersionInfo and their values.

Applies to

See also