Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase AssemblyVersionAttribute

 

Publicado: octubre de 2016

Especifica la versión del ensamblado con atributos.

Espacio de nombres:   System.Reflection
Ensamblado:  mscorlib (en mscorlib.dll)

System.Object
  System.Attribute
    System.Reflection.AssemblyVersionAttribute

[AttributeUsageAttribute(AttributeTargets.Assembly, Inherited = false)]
[ComVisibleAttribute(true)]
public sealed class AssemblyVersionAttribute : Attribute

NombreDescripción
System_CAPS_pubmethodAssemblyVersionAttribute(String)

Inicializa una nueva instancia de la clase AssemblyVersionAttribute con el número de versión del ensamblado con atributos.

NombreDescripción
System_CAPS_pubpropertyTypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.(Heredado de Attribute).

System_CAPS_pubpropertyVersion

Obtiene el número de versión del ensamblado con atributos.

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Esta API admite la infraestructura producto y no está diseñada para usarse directamente desde el código. Devuelve un valor que indica si esta instancia equivale al objeto especificado. (Heredado de Attribute).

System_CAPS_pubmethodGetHashCode()

Devuelve el código hash de esta instancia.(Heredado de Attribute).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodIsDefaultAttribute()

Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada.(Heredado de Attribute).

System_CAPS_pubmethodMatch(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual al objeto especificado. (Heredado de Attribute).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Obtiene la información del tipo de un objeto, que puede utilizarse para obtener la información del tipo de una interfaz. (Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de tipo de información que suministra un objeto (0 ó 1)

(Heredado de Attribute).

System_CAPS_pubinterfaceSystem_CAPS_privmethod_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.(Heredado de Attribute).

El AssemblyVersionAttribute atributo se utiliza para asignar un número de versión a un ensamblado. Este número de versión se almacena con los metadatos del ensamblado.

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. 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). Vea Ensamblados en Common Language Runtime para obtener más información.

System_CAPS_noteNota

La comprobación de versión sólo se produce para los ensamblados con nombres seguros.

El número de versión consta de cuatro partes, como sigue:

< versión >. < versión secundaria >. < número de versión >. < revision >

System_CAPS_importantImportante

Todos los componentes de la versión deben ser enteros mayores que o iguales que 0. Los metadatos restringen principal, secundaria, compilación y los componentes de revisión de un ensamblado a un valor máximo de UInt16.MaxValue - 1. Si un componente supera este valor, se produce un error de compilación.

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 (*). Por ejemplo, [assembly:AssemblyVersion("2.3.25.1")] indica 2 como versión principal, 3 como versión secundaria, 25 como número de compilación y 1 como número de revisión. Un número de versión como [assembly:AssemblyVersion("1.2.*")] especifica 1 como versión principal, 2 como versión secundaria y acepta los números de compilación y de revisión predeterminados. Un número de versión como [assembly:AssemblyVersion("1.2.15.*")] especifica 1 como versión principal, 2 como versión secundaria, 15 como número de compilación y acepta el número de revisión predeterminado. El número de compilación predeterminado incrementa diariamente. El número de revisión predeterminado es el número de segundos transcurridos desde medianoche local hora (sin teniendo en cuenta las modificaciones zona horaria para el horario de verano), dividido por 2.

System_CAPS_noteNota

Si especifica un asterisco para el número de compilación, no puede especificar un número de revisión.

Las versiones principal y secundaria del ensamblado se utilizan como el número de versión de la biblioteca de tipos cuando se exporta el ensamblado. Algunos hosts COM no aceptan bibliotecas de tipos con el número de versión 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 2005 y sin AssemblyVersionAttribute especificado. Debe hacerlo incluso cuando la versión de ensamblado sea 0.0. Todos los proyectos creados en Visual Studio 2005 tiene una versión de ensamblado predeterminada 1.0. *.

Para obtener el nombre de un ensamblado que haya cargado, llame a GetName en el ensamblado que se va a obtener un AssemblyName, y, a continuación, obtenga el Version propiedad. Para obtener el nombre de un ensamblado que no haya cargado, llame a GetAssemblyName desde la aplicación cliente para comprobar la versión de ensamblado que usa su aplicación.

El AssemblyVersionAttribute atributo sólo se puede aplicar una vez. Algunas plantillas de proyecto de Visual Studio ya incluyen el atributo. En estos proyectos, agregando el atributo en el código, se produce un error de compilador.

En el ejemplo siguiente se usa el AssemblyVersionAttribute atributo para asignar un número de versión a un ensamblado. En tiempo de compilación, esta información de versión se almacena con los metadatos del ensamblado. 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 de la Version propiedad de la AssemblyName objeto devuelto por la Assembly.GetName (método).

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.

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: