AssemblyVersionAttribute AssemblyVersionAttribute AssemblyVersionAttribute AssemblyVersionAttribute Class

Definizione

Specifica la versione dell'assembly di cui definire l'attributo.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
Ereditarietà
AssemblyVersionAttributeAssemblyVersionAttributeAssemblyVersionAttributeAssemblyVersionAttribute
Attributi

Esempi

L'esempio seguente usa il AssemblyVersionAttribute attributo per assegnare un numero di versione a un assembly.The following example uses the AssemblyVersionAttribute attribute to assign a version number to an assembly. In fase di compilazione, le informazioni di versione viene archiviate con i metadati dell'assembly.At compile time, this version information is stored with the assembly's metadata. In fase di esecuzione, l'esempio recupera il valore della Type.Assembly trovare la proprietà su un tipo nell'assembly per ottenere un riferimento all'assembly in esecuzione e recupera le informazioni sulla versione dell'assembly dal Version proprietà del AssemblyName oggetto restituito dal Assembly.GetName (metodo).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.

Commenti

Il AssemblyVersionAttribute attributo viene usato per assegnare un numero di versione a un assembly.The AssemblyVersionAttribute attribute is used to assign a version number to an assembly. Tale numero di versione viene quindi archiviato con i metadati dell'assembly.That version number is then stored with the assembly's metadata.

Il numero di versione assembly fa parte di un'identità di assembly e gioca un ruolo determinante nel binding all'assembly e in Criteri di versione.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. I criteri di versione predefiniti del runtime prevedono che l'applicazione venga eseguita solo con le versioni con cui è stata compilata e testata. Per modificare il comportamento predefinito, è possibile esprimere esplicitamente criteri di versione diversi nei file di configurazione (il file di configurazione dell'applicazione, il file dei criteri dell'autore e il file di configurazione dell'amministratore del computer).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). Visualizzare gli assembly in Common Language Runtime per altre informazioni.See Assemblies in the Common Language Runtime for more information.

Nota

Il controllo di versione viene effettuato solo con assembly con nome sicuro.Version checking only occurs with strong-named assemblies.

Il numero di versione costituito da quattro parti, come indicato di seguito:The version number has four parts, as follows:

<versione principale >. <versione secondaria >. <numero build >. <revisione ><major version>.<minor version>.<build number>.<revision>

Importante

Tutti i componenti della versione devono essere numeri interi maggiori o uguali a 0.All components of the version must be integers greater than or equal to 0. Metadati limitano il numero principale, secondario, build e revisione componenti per un assembly a un valore massimo di UInt16.MaxValue - 1.Metadata restricts the major, minor, build, and revision components for an assembly to a maximum value of UInt16.MaxValue - 1. Se un componente supera questo valore, si verifica un errore di compilazione.If a component exceeds this value, a compilation error occurs.

È possibile specificare tutti i valori oppure è possibile accettare il numero di build predefinito, il numero di revisione o entrambi con un asterisco (*).You can specify all the values or you can accept the default build number, revision number, or both by using an asterisk (*). Ad esempio, [assembly:AssemblyVersion("2.3.25.1")] indica come la versione principale 2, 3 come la versione secondaria, 25 come il numero di build e 1 come numero di revisione.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 numero di versione, ad esempio [assembly:AssemblyVersion("1.2.*")] specifica 1 come la versione principale, come la versione secondaria, 2 e accetta i numeri di build e di revisione predefinita.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 numero di versione, ad esempio [assembly:AssemblyVersion("1.2.15.*")] specifica 1 come la versione principale, 2 come la versione secondaria, come il numero di build, 15 e accetta il numero di revisione predefinita.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. Il numero di build predefinito incrementa ogni giorno.The default build number increments daily. Il numero di revisione predefinito è il numero di secondi trascorsi dalla mezzanotte ora locale (senza tenendo regolazioni del fuso orario account per l'ora legale), diviso per 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

Se si specifica un asterisco per il numero di build, è possibile specificare un numero di revisione.If you specify an asterisk for the build number, you cannot specify a revision number.

Le versioni degli assembly principali e secondarie vengono utilizzate come il numero di versione della libreria di tipo quando l'assembly viene esportato.The assembly major and minor versions are used as the type library version number when the assembly is exported. Alcuni host COM non si accettano le librerie dei tipi con il numero di versione 0.0.Some COM hosts do not accept type libraries with the version number 0.0. Pertanto, se si desidera esporre un assembly ai client COM, impostare la versione dell'assembly in modo esplicito a 1.0 nel AssemblyVersionAttribute pagina per i progetti creati esternamente Visual Studio 2005Visual Studio 2005 e senza alcun AssemblyVersionAttribute specificato.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. Eseguire questa operazione anche quando la versione dell'assembly è 0,0.Do this even when the assembly version is 0.0. Tutti i progetti creati Visual Studio 2005Visual Studio 2005 hanno una versione dell'assembly predefinito pari a 1,0. *.All projects created in Visual Studio 2005Visual Studio 2005 have a default assembly version of 1.0.*.

Per ottenere il nome di un assembly sono stati caricati, chiamare GetName sull'assembly per ottenere un AssemblyNamee quindi ottenere il Version proprietà.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. Per ottenere il nome di un assembly non sono stati caricati, chiamare GetAssemblyName dall'applicazione client per verificare la versione dell'assembly usati dall'applicazione.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.

Il AssemblyVersionAttribute attributo può essere applicato una sola volta.The AssemblyVersionAttribute attribute can only be applied once. Alcuni modelli di progetto di Visual Studio includono già l'attributo.Some Visual Studio project templates already include the attribute. Nei progetti, aggiungendo l'attributo nel codice causa un errore del compilatore.In those projects, adding the attribute in code causes a compiler error.

Costruttori

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

Inizializza una nuova istanza della classe AssemblyVersionAttribute con il numero di versione dell'assembly di cui definire l'attributo.Initializes a new instance of the AssemblyVersionAttribute class with the version number of the assembly being attributed.

Proprietà

TypeId TypeId TypeId TypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)
Version Version Version Version

Ottiene il numero di versione dell'assembly con attributi.Gets the version number of the attributed assembly.

Metodi

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

Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.Returns a value that indicates whether this instance is equal to a specified object.

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

Restituisce il codice hash per l'istanza.Returns the hash code for this instance.

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

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

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

In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.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)

Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato.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 superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

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

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

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

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.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)

Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia.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 il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 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)

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Si applica a

Vedi anche