AssemblyVersionAttribute Třída

Definice

Obor názvů:

System.Reflection

Sestavení:

System.Runtime.dll

Zdroj:

AssemblyVersionAttribute.cs

Určuje verzi přiřazeného sestavení.

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

Dědičnost

Object

Attribute

AssemblyVersionAttribute

Atributy

AttributeUsageAttribute

Příklady

Následující příklad používá AssemblyVersionAttribute atribut k přiřazení čísla verze sestavení. V době kompilace jsou tyto informace o verzi uloženy s metadaty sestavení. Za běhu příklad načte hodnotu Type.Assembly vlastnosti typu nalezeného v sestavení, aby získal odkaz na spuštěné sestavení, a načte informace o verzi sestavení z Version vlastnosti objektu AssemblyName vráceného metodou 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.

Poznámky

Atribut AssemblyVersionAttribute slouží k přiřazení čísla verze sestavení. Toto číslo verze se pak uloží s metadaty sestavení.

Číslo verze sestavení je součástí identity sestavení a hraje klíčovou roli při vazbě na sestavení a v zásadách verzí. Výchozí zásadou verze pro modul runtime je, že aplikace běží pouze s verzemi, se kterými byly vytvořeny a testovány, pokud nejsou přepsány explicitními zásadami verze v konfiguračních souborech (konfigurační soubor aplikace, soubor zásad vydavatele a konfigurační soubor správce počítače). Další informace najdete v tématu Sestavení v .NET .

Poznámka

Kontrola verzí probíhá pouze u sestavení se silným názvem.

Číslo verze má čtyři části:

<hlavní verze>.<podverze>.<číslo buildu>.<Revize>

Důležité

Všechny součásti verze musí být celá čísla větší než nebo rovna 0. Metadata omezují hlavní komponenty, podverze, sestavení a revize sestavení na maximální hodnotu UInt16.MaxValue - 1. Pokud komponenta tuto hodnotu překročí, dojde k chybě kompilace.

Můžete zadat všechny hodnoty nebo můžete přijmout výchozí číslo sestavení, číslo revize nebo obojí hvězdičkou (*). Například [assembly:AssemblyVersion("2.3.25.1")] označuje 2 jako hlavní verzi, 3 jako podverzi, 25 jako číslo sestavení a 1 jako číslo revize. Číslo verze, například [assembly:AssemblyVersion("1.2.*")] určuje 1 jako hlavní verzi, 2 jako podverzi a přijímá výchozí čísla sestavení a revizí. Číslo verze, například [assembly:AssemblyVersion("1.2.15.*")] určuje 1 jako hlavní verzi, 2 jako podverzi, 15 jako číslo sestavení a přijímá výchozí číslo revize. Výchozí číslo buildu se každý den zvýší. Výchozí číslo revize je počet sekund od půlnoci místního času (bez zohlednění úprav časových pásem pro letní čas) dělený 2.

Poznámka

Pokud jako číslo sestavení zadáte hvězdičku, nemůžete zadat číslo revize.

Hlavní verze sestavení a podverze se při exportu sestavení používají jako číslo verze knihovny typů. Někteří hostitelé modelu COM nepřijímají knihovny typů s číslem verze 0.0. Proto pokud chcete vystavit sestavení klientům COM, nastavte verzi sestavení explicitně na 1.0 na AssemblyVersionAttribute stránce pro projekty vytvořené mimo Visual Studio 2005 a bez AssemblyVersionAttribute zadané. To udělejte i v případě, že je verze sestavení 0.0. Všechny projekty vytvořené v sadě Visual Studio 2005 mají výchozí verzi sestavení 1.0.*.

Pokud chcete získat název sestavení, které jste načetli, zavolejte GetName sestavení, abyste získali AssemblyName, a pak získejte Version vlastnost. Pokud chcete získat název sestavení, které jste nenačetli, zavolejte GetAssemblyName z klientské aplikace a zkontrolujte verzi sestavení, kterou vaše aplikace používá.

Atribut AssemblyVersionAttribute lze použít pouze jednou. Některé šablony projektů sady Visual Studio již atribut obsahují. V těchto projektech způsobí přidání atributu do kódu chybu kompilátoru.

Konstruktory

AssemblyVersionAttribute(String)

Inicializuje novou instanci AssemblyVersionAttribute třídy s číslem verze sestavení, které je přiřazeno.

Vlastnosti

TypeId	Při implementaci v odvozené třídě získá jedinečný identifikátor pro tuto Attributetřídu . (Zděděno od Attribute)
Version	Získá číslo verze přiřazeného sestavení.

Metody

Equals(Object)	Vrací hodnotu, která určuje, zda je tato instance rovna zadanému objektu. (Zděděno od Attribute)
GetHashCode()	Vrátí hodnotu hash pro tuto instanci. (Zděděno od Attribute)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
IsDefaultAttribute()	Při přepsání v odvozené třídě označuje, zda je hodnota této instance výchozí hodnotou pro odvozenou třídu. (Zděděno od Attribute)
Match(Object)	Při přepsání v odvozené třídě vrátí hodnotu, která označuje, zda se tato instance rovná zadanému objektu. (Zděděno od Attribute)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• Version
• Nastavování atributů sestavení
• Správa verzí sestavení
• Metadata a komponenty Self-Describing
• Proces spravovaného spouštění
• Sestavení v .NET