AssemblyVersionAttribute Classe

Definição

public ref class AssemblyVersionAttribute sealed : 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

[<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

Herança

Object

Attribute

AssemblyVersionAttribute

Atributos

AttributeUsageAttribute ComVisibleAttribute

Exemplos

O exemplo seguinte usa o AssemblyVersionAttribute atributo para atribuir um número de versão a uma assembleia. No momento da compilação, esta informação de versão é armazenada com os metadados do assembly. Em tempo de execução, o exemplo recupera o valor da Type.Assembly propriedade num tipo encontrado na montagem para obter uma referência à montagem em execução, e recupera a informação da versão da montagem a partir da Version propriedade do AssemblyName objeto devolvida pelo 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.

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.

Observações

O AssemblyVersionAttribute atributo é usado para atribuir um número de versão a uma assembleia. Esse número de versão é então armazenado com os metadados da assembleia.

O número de versão da assembly faz parte da identidade de uma assembly e desempenha um papel fundamental na ligação à assembly e à política de versão. A política de versão padrão para o tempo de execução é que os aplicativos são executados somente com as versões com as quais foram criados e testados, a menos que sejam substituídos pela política de versão explícita nos arquivos de configuração (o arquivo de configuração do aplicativo, o arquivo de diretiva do editor e o arquivo de configuração do administrador do computador). Consulte Assemblies in .NET para mais informações.

O número de versão tem quatro partes, da seguinte forma:

<versão principal>.<versão menor>.<número de compilação>.<revisão>

Por exemplo, [assembly:AssemblyVersion("2.3.25.1")] indica 2 como versão principal, 3 como versão menor, 25 como número de construção e 1 como número de revisão.

O AssemblyVersionAttribute atributo permite-lhe especificar um asterisco (*) em vez do número de compilação ou revisão. Um número de versão, como o [assembly:AssemblyVersion("1.2.*")] 1, especifica 1 como a versão principal e o 2 como a versão menor, aceitando os números padrão de compilação e revisão. Um número de versão como [assembly:AssemblyVersion("1.2.15.*")] especifica 1 como a versão principal, 2 como a versão menor e 15 como número de compilação, aceitando o número de revisão padrão. O número de build padrão aumenta diariamente. O número padrão da revisão é o número de segundos desde a meia-noite, hora local, (sem considerar os ajustes de fuso horário para o horário de verão), dividido por 2. Se especificares um asterisco para o número de compilação, não podes especificar um número de revisão.

Pode mitigar alguns destes problemas limitando o uso de versões baseadas no tempo para lançar compilações com compilação condicional, assim:

#if DEBUG
[assembly: AssemblyVersion("1.0.0.0")]
#else
[assembly: AssemblyVersion("1.0.*")]
#endif

Uma abordagem melhor para o versionamento é derivar a versão assembly ou do ficheiro a partir do HEAD commit SHA (para repositórios git). Veja, por exemplo, Nerdbank.GitVersioning.

As versões maior e menor da montagem são usadas como número de versão da biblioteca de tipos quando a montagem é exportada. Alguns hosts COM não aceitam bibliotecas de tipos com o número de versão 0.0. Portanto, se quiseres expor um assembly a clientes COM, define explicitamente a versão assembly para 1.0 na página AssemblyVersionAttribute para projetos criados fora de Visual Studio 2005 e sem AssemblyVersionAttribute especificado. Faz isto mesmo quando a versão assembly for 0.0. Todos os projetos criados no Visual Studio 2005 têm uma versão assembly padrão da 1.0.*.

Para obter o nome de um conjunto que carregaste, chama GetName o conjunto para obter um AssemblyName, e depois obtenha a Version propriedade. Para obter o nome de um assembly que ainda não carregaste, liga GetAssemblyName a partir da tua aplicação cliente para verificar a versão assembly que a tua aplicação utiliza.

O AssemblyVersionAttribute atributo só pode ser aplicado uma vez. Alguns modelos de projetos do Visual Studio já incluem esse atributo. Nesses projetos, adicionar o atributo no código causa um erro do compilador.

Ver também

• Version
• Definir atributos de assemblagem
• Versionamento de assembly
• Metadados e componentes Self-Describing
• Processo de Execução Gerenciado
• Assembleias em .NET