CA1016: Tandai rakitan dengan AssemblyVersionAttribute

Properti Nilai
ID Aturan CA1016
Judul Menandai rakitan dengan AssemblyVersionAttribute
Kategori Desain
Perbaikan bersifat merusak atau tidak merusak Tidak terputus
Diaktifkan secara default di .NET 10 Sebagai saran
Bahasa yang berlaku C# dan Visual Basic

Penyebab

Perakitan tidak memiliki nomor versi.

Deskripsi aturan

Identitas assembly terdiri dari informasi berikut:

  • Nama Asambel

  • Nomor versi

  • Kultur

  • Kunci publik (untuk rakitan bernama kuat).

.NET menggunakan nomor versi untuk mengidentifikasi arsitektur secara unik dan untuk menghubungkan ke tipe-tipe dalam rakitan yang diberi nama kuat. Nomor versi digunakan bersama dengan versi dan kebijakan penerbit. Secara default, aplikasi hanya berjalan dengan versi rakitan yang digunakan saat pembangunan.

Cara memperbaiki pelanggaran

Untuk memperbaiki pelanggaran aturan ini, tambahkan nomor versi ke rakitan dengan menggunakan System.Reflection.AssemblyVersionAttribute atribut .

Kapan harus menekan peringatan

Jangan menahan peringatan dari aturan ini untuk komponen yang digunakan oleh pihak ketiga atau di lingkungan produksi.

Menyembunyikan peringatan

Jika Anda hanya ingin menyembunyikan satu pelanggaran, tambahkan arahan praprosedur ke file sumber Anda untuk dinonaktifkan lalu aktifkan kembali aturannya.

#pragma warning disable CA1016
// The code that's violating the rule is on this line.
#pragma warning restore CA1016

Untuk menonaktifkan aturan untuk file, folder, atau proyek, atur tingkat keparahannya ke none dalam file konfigurasi.

[*.{cs,vb}]
dotnet_diagnostic.CA1016.severity = none

Untuk informasi selengkapnya, lihat Cara menyembunyikan peringatan analisis kode.

Contoh

Contoh berikut menunjukkan rakitan yang memiliki AssemblyVersionAttribute atribut yang diterapkan.

using System;
using System.Reflection;

[assembly: AssemblyVersionAttribute("4.3.2.1")]
namespace DesignLibrary {}
<Assembly: AssemblyVersionAttribute("4.3.2.1")>
Namespace DesignLibrary
End Namespace

Lihat juga