AssemblyVersionAttribute Kelas

Definisi

Ruang nama:

System.Reflection

Rakitan:

System.Runtime.dll

Sumber:

AssemblyVersionAttribute.cs

Menentukan versi assembly yang dikaitkan.

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

Warisan

Object

Attribute

AssemblyVersionAttribute

Atribut

AttributeUsageAttribute

Contoh

Contoh berikut menggunakan AssemblyVersionAttribute atribut untuk menetapkan nomor versi ke assembly. Pada waktu kompilasi, informasi versi ini disimpan dengan metadata perakitan. Pada durasi, contoh mengambil nilai Type.Assembly properti pada jenis yang ditemukan di perakitan untuk mendapatkan referensi ke rakitan yang dieksekusi, dan mengambil informasi versi rakitan dari Version properti AssemblyName objek yang dikembalikan oleh Assembly.GetName metode .

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.

Keterangan

Atribut AssemblyVersionAttribute digunakan untuk menetapkan nomor versi ke assembly. Nomor versi tersebut kemudian disimpan dengan metadata assembly.

Nomor versi assembly adalah bagian dari identitas assembly dan memainkan bagian kunci dalam mengikat assembly dan dalam kebijakan versi. Kebijakan versi default untuk runtime adalah bahwa aplikasi hanya berjalan dengan versi yang mereka buat dan diuji dengan, kecuali diganti dengan kebijakan versi eksplisit dalam file konfigurasi (file konfigurasi aplikasi, file kebijakan penerbit, dan file konfigurasi administrator komputer). Lihat Rakitan di .NET untuk informasi selengkapnya.

Catatan

Pemeriksaan versi hanya terjadi dengan assembly bernama kuat.

Nomor versi memiliki empat bagian, sebagai berikut:

<versi> utama.<versi> minor.<nomor> build.<Revisi>

Penting

Semua komponen versi harus bilangan bulat yang lebih besar dari atau sama dengan 0. Metadata membatasi komponen utama, minor, build, dan revisi untuk perakitan ke nilai UInt16.MaxValue maksimum - 1. Jika komponen melebihi nilai ini, kesalahan kompilasi terjadi.

Anda dapat menentukan semua nilai atau Anda dapat menerima nomor build default, nomor revisi, atau keduanya dengan menggunakan tanda bintang (*). Misalnya, [assembly:AssemblyVersion("2.3.25.1")] menunjukkan 2 sebagai versi utama, 3 sebagai versi minor, 25 sebagai nomor build, dan 1 sebagai nomor revisi. Nomor versi seperti [assembly:AssemblyVersion("1.2.*")] menentukan 1 sebagai versi utama, 2 sebagai versi minor, dan menerima nomor build dan revisi default. Nomor versi seperti [assembly:AssemblyVersion("1.2.15.*")] menentukan 1 sebagai versi utama, 2 sebagai versi minor, 15 sebagai nomor build, dan menerima nomor revisi default. Kenaikan angka build default setiap hari. Nomor revisi default adalah jumlah detik sejak tengah malam waktu setempat (tanpa mempertimbangkan penyesuaian zona waktu untuk waktu musim panas), dibagi dengan 2.

Catatan

Jika Anda menentukan tanda bintang untuk nomor build, Anda tidak dapat menentukan nomor revisi.

Versi rakitan utama dan minor digunakan sebagai nomor versi pustaka jenis saat rakitan diekspor. Beberapa host COM tidak menerima pustaka jenis dengan nomor versi 0.0. Oleh karena itu, jika Anda ingin mengekspos rakitan ke klien COM, atur versi rakitan secara eksplisit ke 1.0 di AssemblyVersionAttribute halaman untuk proyek yang dibuat di luar Visual Studio 2005 dan tanpa AssemblyVersionAttribute ditentukan. Lakukan ini bahkan ketika versi assembly adalah 0.0. Semua proyek yang dibuat di Visual Studio 2005 memiliki versi rakitan default 1.0.*.

Untuk mendapatkan nama assembly yang telah Anda muat, panggil GetName assembly untuk mendapatkan AssemblyName, lalu dapatkan Version properti . Untuk mendapatkan nama assembly yang belum Anda muat, panggil GetAssemblyName dari aplikasi klien Anda untuk memeriksa versi assembly yang digunakan aplikasi Anda.

Atribut AssemblyVersionAttribute hanya dapat diterapkan sekali. Beberapa templat proyek Visual Studio sudah menyertakan atribut . Dalam proyek tersebut, menambahkan atribut dalam kode menyebabkan kesalahan kompilator.

Konstruktor

AssemblyVersionAttribute(String)

Menginisialisasi instans AssemblyVersionAttribute baru kelas dengan nomor versi assembly yang diatribusikan.

Properti

TypeId	Ketika diimplementasikan di kelas turunan, mendapatkan pengidentifikasi unik untuk ini Attribute. (Diperoleh dari Attribute)
Version	Mendapatkan nomor versi rakitan yang diatribusikan.

Metode

Equals(Object)	Mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
GetHashCode()	Mengembalikan kode hash untuk instans ini. (Diperoleh dari Attribute)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
IsDefaultAttribute()	Ketika ditimpa di kelas turunan, menunjukkan apakah nilai instans ini adalah nilai default untuk kelas turunan. (Diperoleh dari Attribute)
Match(Object)	Saat ditimpa di kelas turunan, mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu. (Diperoleh dari Attribute)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• Version
• Mengatur atribut assembly
• Penerapan versi assembly
• Metadata dan Komponen yang Menjelaskan Sendiri
• Proses Eksekusi Terkelola
• Perakitan di .NET