AssemblyVersionAttribute Clase

Definición

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

public ref class AssemblyVersionAttribute sealed : Attribute
public sealed class AssemblyVersionAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)]
public sealed class AssemblyVersionAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false)]
public sealed class AssemblyVersionAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class AssemblyVersionAttribute : Attribute
type AssemblyVersionAttribute = class
    inherit Attribute
[<System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)>]
type AssemblyVersionAttribute = class
    inherit Attribute
[<System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false)>]
type AssemblyVersionAttribute = class
    inherit Attribute
[<System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type AssemblyVersionAttribute = class
    inherit Attribute
Public NotInheritable Class AssemblyVersionAttribute
Inherits Attribute
Herencia
AssemblyVersionAttribute
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 en ejecución y recupera la información de versión del ensamblado de la Version propiedad del AssemblyName objeto devuelto por el 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. Ese número de versión se almacena a continuación 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 desempeña una parte fundamental en el enlace con el ensamblado y en la Directiva de versiones.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). Vea ensamblados en .net para obtener más información.See Assemblies in .NET 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 se indica a continuación:The version number has four parts, as follows:

<major version>.<minor version>.<build number>.<revision><major version>.<minor version>.<build number>.<revision>

Importante

Todos los componentes de la versión deben ser números enteros mayores o iguales que 0.All components of the version must be integers greater than or equal to 0. Los metadatos restringen los componentes principal, secundario, de compilación y de revisión de un ensamblado a un 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 predeterminado, 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 como 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 la versión principal, 2 como la versión secundaria, y acepta los números de compilación y de 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 la versión principal, 2 como la versión secundaria, 15 como el número de compilación y acepta el número de revisión predeterminado.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 predeterminado es el número de segundos transcurridos desde la medianoche de la hora local (sin tener en cuenta los ajustes de zona horaria para el 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 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 clientes COM, establezca la versión de ensamblado explícitamente en 1,0 en la AssemblyVersionAttribute Página para los proyectos creados fuera de Visual Studio 2005Visual Studio 2005 y sin AssemblyVersionAttribute especificar.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 sea 0,0.Do this even when the assembly version is 0.0. Todos los proyectos creados en Visual Studio 2005Visual Studio 2005 tienen 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 ha cargado, llame GetName a en el ensamblado para obtener AssemblyName y, a continuación, obtenga la 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 ha cargado, llame a GetAssemblyName desde la aplicación cliente para comprobar la versión de ensamblado que usa la 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 esos proyectos, al agregar el atributo en el código se produce un error del compilador.In those projects, adding the attribute in code causes a compiler error.

Constructores

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

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.

(Heredado de Attribute)
Version

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

Métodos

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.

(Heredado de Attribute)
GetHashCode()

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

(Heredado de Attribute)
GetType()

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

(Heredado de Object)
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.

(Heredado de Attribute)
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.

(Heredado de Attribute)
MemberwiseClone()

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

(Heredado de Object)
ToString()

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

(Heredado de Object)

Implementaciones de interfaz explícitas

_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.

(Heredado de Attribute)
_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.

(Heredado de Attribute)
_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).

(Heredado de Attribute)
_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.

(Heredado de Attribute)

Se aplica a

Consulte también