AssemblyVersionAttribute Klasa

Definicja

Przestrzeń nazw:

System.Reflection

Zestaw:

System.Runtime.dll

Źródło:

AssemblyVersionAttribute.cs

Określa wersję przypisywanego zestawu.

public ref class AssemblyVersionAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)]
public sealed class AssemblyVersionAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly, Inherited=false)>]
type AssemblyVersionAttribute = class
    inherit Attribute

Public NotInheritable Class AssemblyVersionAttribute
Inherits Attribute

Dziedziczenie

Object

Attribute

AssemblyVersionAttribute

Atrybuty

AttributeUsageAttribute

Przykłady

W poniższym przykładzie użyto atrybutu AssemblyVersionAttribute w celu przypisania numeru wersji do zestawu. W czasie kompilacji te informacje o wersji są przechowywane z metadanymi zestawu. W czasie wykonywania przykład pobiera wartość Type.Assembly właściwości w typie znalezionym w zestawie, aby uzyskać odwołanie do wykonywanego zestawu i pobiera informacje o wersji zestawu z Version właściwości AssemblyName obiektu zwróconego przez metodę Assembly.GetName .

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.

Uwagi

Atrybut AssemblyVersionAttribute służy do przypisywania numeru wersji do zestawu. Numer wersji jest następnie przechowywany z metadanymi zestawu.

Numer wersji zestawu jest częścią tożsamości zestawu i odgrywa kluczową rolę w powiązaniu z zestawem i zasadami wersji. Domyślna zasada dotycząca wersji środowiska dla środowiska uruchomieniowego stanowi, że aplikacje są uruchamiane tylko w wersjach, w których zostały skompilowane i przetestowane, chyba że inaczej stanowią jawnie zasady dotyczące wersji określone w plikach konfiguracji (plik konfiguracji aplikacji, plik zasad wydawcy i plik konfiguracji administratora komputera). Aby uzyskać więcej informacji, zobacz Zestawy na platformie .NET .

Uwaga

Sprawdzanie wersji dotyczy tylko zestawów o silnej nazwie.

Numer wersji ma cztery części w następujący sposób:

<wersja> główna.<wersja pomocnicza>.<numer kompilacji>.<— zmiana>

Ważne

Wszystkie składniki wersji muszą być liczbą całkowitą większą lub równą 0. Metadane ograniczają główne, pomocnicze, kompilowanie i poprawki składniki zestawu do maksymalnej UInt16.MaxValue wartości – 1. Jeśli składnik przekroczy tę wartość, wystąpi błąd kompilacji.

Możesz określić wszystkie wartości lub zaakceptować domyślny numer kompilacji, numer poprawki lub oba za pomocą gwiazdki (*). Na przykład [assembly:AssemblyVersion("2.3.25.1")] wskazuje 2 jako wersję główną, 3 jako wersję pomocniczą, 25 jako numer kompilacji i 1 jako numer poprawki. Numer wersji, taki jak [assembly:AssemblyVersion("1.2.*")] określa 1 jako wersję główną, 2 jako wersję pomocniczą i akceptuje domyślne numery kompilacji i poprawek. Numer wersji, taki jak [assembly:AssemblyVersion("1.2.15.*")] określa 1 jako wersję główną, 2 jako wersję pomocniczą, 15 jako numer kompilacji i akceptuje domyślny numer poprawki. Domyślny numer kompilacji zwiększa się codziennie. Domyślny numer poprawki to liczba sekund od północy czasu lokalnego (bez uwzględniania korekt strefy czasowej dla czasu letniego), podzielona przez 2.

Uwaga

Jeśli określisz gwiazdkę dla numeru kompilacji, nie można określić numeru poprawki.

Wersje główne i pomocnicze zestawu są używane jako numer wersji biblioteki typów podczas eksportowania zestawu. Niektóre hosty COM nie akceptują bibliotek typów z numerem wersji 0.0. W związku z tym, jeśli chcesz uwidocznić zestaw dla klientów COM, ustaw wersję zestawu jawnie na 1.0 na AssemblyVersionAttribute stronie dla projektów utworzonych poza programem Visual Studio 2005 i bez określonego AssemblyVersionAttribute . Zrób to nawet wtedy, gdy wersja zestawu to 0.0. Wszystkie projekty utworzone w programie Visual Studio 2005 mają domyślną wersję zestawu 1.0.*.

Aby uzyskać nazwę załadowanego zestawu, wywołaj GetName zestaw, aby uzyskać AssemblyNamewłaściwość , a następnie pobierz Version właściwość . Aby uzyskać nazwę zestawu, którego nie załadowano, wywołaj wywołanie GetAssemblyName z aplikacji klienckiej, aby sprawdzić wersję zestawu używaną przez aplikację.

Atrybut AssemblyVersionAttribute można zastosować tylko raz. Niektóre szablony projektów programu Visual Studio zawierają już atrybut. W tych projektach dodanie atrybutu w kodzie powoduje błąd kompilatora.

Konstruktory

AssemblyVersionAttribute(String)

Inicjuje AssemblyVersionAttribute nowe wystąpienie klasy z numerem wersji przypisywanego zestawu.

Właściwości

TypeId	Po zaimplementowaniu w klasie pochodnej pobiera unikatowy identyfikator dla tego elementu Attribute. (Odziedziczone po Attribute)
Version	Pobiera numer wersji przypisanego zestawu.

Metody

Equals(Object)	Zwraca wartość wskazującą, czy to wystąpienie jest równe podanemu obiektowi. (Odziedziczone po Attribute)
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia. (Odziedziczone po Attribute)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
IsDefaultAttribute()	W przypadku zastąpienia w klasie pochodnej wskazuje, czy wartość tego wystąpienia jest wartością domyślną klasy pochodnej. (Odziedziczone po Attribute)
Match(Object)	W przypadku zastąpienia w klasie pochodnej zwraca wartość wskazującą, czy to wystąpienie jest równe określonemu obiektowi. (Odziedziczone po Attribute)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• Version
• Ustawianie atrybutów zestawu
• Przechowywanie wersji zestawu
• Metadane i składniki Self-Describing
• Zarządzany proces wykonywania
• Zestawy w środowisku .NET