AssemblyVersionAttribute AssemblyVersionAttribute AssemblyVersionAttribute AssemblyVersionAttribute Class

Definición

Especifica la versión del ensamblado con atributos.Specifies the version of the assembly being attributed.

public ref class AssemblyVersionAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false)]
public sealed class AssemblyVersionAttribute : Attribute
type AssemblyVersionAttribute = class
    inherit Attribute
Public NotInheritable Class AssemblyVersionAttribute
Inherits Attribute
Herencia
AssemblyVersionAttributeAssemblyVersionAttributeAssemblyVersionAttributeAssemblyVersionAttribute
Atributos

Ejemplos

En el ejemplo siguiente se usa el AssemblyVersionAttribute atributo para asignar un número de versión a un ensamblado.The following example uses the AssemblyVersionAttribute attribute to assign a version number to an assembly. En tiempo de compilación, esta información de versión se almacena con los metadatos del ensamblado.At compile time, this version information is stored with the assembly's metadata. En tiempo de ejecución, el ejemplo recupera el valor de la Type.Assembly propiedad en un tipo que se encuentra en el ensamblado para obtener una referencia al ensamblado que se ejecuta y recupera información de versión del ensamblado desde el Version propiedad de la AssemblyName objeto devuelto por la Assembly.GetName método.At run time, the example retrieves the value of the Type.Assembly property on a type found in the assembly to get a reference to the executing assembly, and it retrieves the assembly's version information from the Version property of the AssemblyName object returned by the Assembly.GetName method.

using System;
using System.Reflection;

[assembly:AssemblyVersionAttribute("2.0.1")]

public class Example1
{
   public static void Main()
   {
      Assembly thisAssem = typeof(Example1).Assembly;
      AssemblyName thisAssemName = thisAssem.GetName();
       
      Version ver = thisAssemName.Version;
       
      Console.WriteLine("This is version {0} of {1}.", ver, thisAssemName.Name);    
   }
}
// The example displays the following output:
//        This is version 2.0.1.0 of Example1.
Imports System.Reflection

<Assembly:AssemblyVersionAttribute("2.0.1")>
Module Example1
   Public Sub Main()
       Dim thisAssem As Assembly = GetType(Example1).Assembly
       Dim thisAssemName As AssemblyName = thisAssem.GetName()
       
       Dim ver As Version = thisAssemName.Version
       
       Console.WriteLine("This is version {0} of {1}.", ver, thisAssemName.Name)    
   End Sub
End Module
' The example displays the following output:
'      This is version 2.0.1.0 of Example1.

Comentarios

El AssemblyVersionAttribute atributo se utiliza para asignar un número de versión a un ensamblado.The AssemblyVersionAttribute attribute is used to assign a version number to an assembly. Este número de versión, a continuación, se almacena con los metadatos del ensamblado.That version number is then stored with the assembly's metadata.

El número de versión del ensamblado forma parte de la identidad de un ensamblado y juega un papel importante en el enlace para el ensamblado y en la directiva de versión.The assembly version number is part of an assembly's identity and plays a key part in binding to the assembly and in version policy. La directiva de versiones predeterminada para el motor en tiempo de ejecución es que las aplicaciones se ejecuten sólo en las versiones con las que se compilaron y comprobaron, a menos que se reemplace con una directiva de versiones explícita en los archivos de configuración (el archivo de configuración de la aplicación, el archivo de directivas de la compañía de software y el archivo de configuración del administrador del equipo).The default version policy for the runtime is that applications run only with the versions they were built and tested with, unless overridden by explicit version policy in configuration files (the application configuration file, the publisher policy file, and the computer's administrator configuration file). Consulte ensamblados en Common Language Runtime para obtener más información.See Assemblies in the Common Language Runtime for more information.

Nota

La comprobación de versión sólo se produce para los ensamblados con nombres seguros.Version checking only occurs with strong-named assemblies.

El número de versión tiene cuatro partes, como sigue:The version number has four parts, as follows:

<versión principal >. <versión secundaria >. <número de compilación >. <revisión ><major version>.<minor version>.<build number>.<revision>

Importante

Todos los componentes de la versión deben ser enteros mayores o iguales que 0.All components of the version must be integers greater than or equal to 0. Metadatos restringen la principal, secundaria, compilación y revisión de componentes para un ensamblado y el valor máximo de UInt16.MaxValue - 1.Metadata restricts the major, minor, build, and revision components for an assembly to a maximum value of UInt16.MaxValue - 1. Si un componente supera este valor, se produce un error de compilación.If a component exceeds this value, a compilation error occurs.

Puede especificar todos los valores o puede aceptar el número de compilación de forma predeterminada, el número de revisión o ambos mediante un asterisco (*).You can specify all the values or you can accept the default build number, revision number, or both by using an asterisk (*). Por ejemplo, [assembly:AssemblyVersion("2.3.25.1")] indica 2 como la versión principal, 3 es la versión secundaria, 25 como el número de compilación y 1 como número de revisión.For example, [assembly:AssemblyVersion("2.3.25.1")] indicates 2 as the major version, 3 as the minor version, 25 as the build number, and 1 as the revision number. Un número de versión como [assembly:AssemblyVersion("1.2.*")] especifica 1 como versión principal, 2 es la versión secundaria y acepta los números de compilación y revisión predeterminados.A version number such as [assembly:AssemblyVersion("1.2.*")] specifies 1 as the major version, 2 as the minor version, and accepts the default build and revision numbers. Un número de versión como [assembly:AssemblyVersion("1.2.15.*")] especifica 1 como versión principal, 2 es la versión secundaria, 15 como el número de compilación y acepta el número de revisión predeterminada.A version number such as [assembly:AssemblyVersion("1.2.15.*")] specifies 1 as the major version, 2 as the minor version, 15 as the build number, and accepts the default revision number. El número de compilación predeterminado incrementa diariamente.The default build number increments daily. El número de revisión predeterminada es el número de segundos transcurridos desde medianoche local hora (sin tener en cuenta las modificaciones zona horaria al horario de verano), dividido por 2.The default revision number is the number of seconds since midnight local time (without taking into account time zone adjustments for daylight saving time), divided by 2.

Nota

Si especifica un asterisco para el número de compilación, no se puede especificar un número de revisión.If you specify an asterisk for the build number, you cannot specify a revision number.

Las versiones principal y secundaria del ensamblado se usan como el número de versión de la biblioteca de tipos cuando se exporta el ensamblado.The assembly major and minor versions are used as the type library version number when the assembly is exported. Algunos hosts COM no aceptan bibliotecas de tipos con el número de versión 0.0.Some COM hosts do not accept type libraries with the version number 0.0. Por lo tanto, si desea exponer un ensamblado a los clientes COM, establezca la versión del ensamblado explícitamente en 1.0 en la AssemblyVersionAttribute página para los proyectos creados fuera Visual Studio 2005Visual Studio 2005 y sin AssemblyVersionAttribute especificado.Therefore, if you want to expose an assembly to COM clients, set the assembly version explicitly to 1.0 in the AssemblyVersionAttribute page for projects created outside Visual Studio 2005Visual Studio 2005 and with no AssemblyVersionAttribute specified. Haga esto incluso cuando la versión del ensamblado es 0.0.Do this even when the assembly version is 0.0. Todos los proyectos creados en Visual Studio 2005Visual Studio 2005 tiene una versión de ensamblado predeterminada de 1.0. *.All projects created in Visual Studio 2005Visual Studio 2005 have a default assembly version of 1.0.*.

Para obtener el nombre de un ensamblado que haya cargado, llame a GetName en el ensamblado para obtener un AssemblyNamey, a continuación, obtenga el Version propiedad.To get the name of an assembly you have loaded, call GetName on the assembly to get an AssemblyName, and then get the Version property. Para obtener el nombre de un ensamblado que no haya cargado, llame a GetAssemblyName desde la aplicación cliente para comprobar la versión del ensamblado que usa su aplicación.To get the name of an assembly you have not loaded, call GetAssemblyName from your client application to check the assembly version that your application uses.

El AssemblyVersionAttribute atributo solo se puede aplicar una vez.The AssemblyVersionAttribute attribute can only be applied once. Algunas plantillas de proyecto de Visual Studio ya incluyen el atributo.Some Visual Studio project templates already include the attribute. En los proyectos, agregar el atributo en el código provoca un error del compilador.In those projects, adding the attribute in code causes a compiler error.

Constructores

AssemblyVersionAttribute(String) AssemblyVersionAttribute(String) AssemblyVersionAttribute(String) AssemblyVersionAttribute(String)

Inicializa una nueva instancia de la clase AssemblyVersionAttribute con el número de versión del ensamblado con atributos.Initializes a new instance of the AssemblyVersionAttribute class with the version number of the assembly being attributed.

Propiedades

TypeId TypeId TypeId TypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)
Version Version Version Version

Obtiene el número de versión del ensamblado con atributos.Gets the version number of the attributed assembly.

Métodos

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Devuelve un valor que indica si esta instancia es igual que un objeto especificado.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Devuelve el código hash de esta instancia.Returns the hash code for this instance.

(Inherited from Attribute)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Implementaciones de interfaz explícitas

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Se aplica a

Consulte también: