Bagikan melalui


Gambaran umum analisis warisan untuk kode terkelola di Visual Studio

Visual Studio dapat melakukan analisis kode dari kode terkendali dengan dua cara: dengan analisis lama, juga dikenal sebagai analisis statik FxCop dari rakitan terkelola, dan dengan penganalisis kode berbasis .NET Compiler Platform yang lebih modern. Topik ini mencakup analisis warisan. Untuk mempelajari selengkapnya tentang analisis kode berbasis .NET Compiler Platform, lihat Gambaran umum penganalisis berbasis .NET Compiler Platform.

Analisis kode untuk kode terkelola menganalisis rakitan terkelola dan melaporkan informasi tentang rakitan, seperti pelanggaran aturan pemrograman dan desain yang ditetapkan dalam Pedoman Desain .NET.

Alat analisis mewakili pemeriksaan yang dilakukannya selama analisis sebagai pesan peringatan. Pesan peringatan mengidentifikasi masalah pemrograman dan desain yang relevan dan, jika memungkinkan, berikan informasi tentang cara memperbaiki masalah.

Catatan

Analisis warisan (analisis kode statis) tidak didukung untuk proyek .NET Core dan .NET Standard dalam Visual Studio. Jika Anda menjalankan analisis kode pada proyek .NET Core atau .NET Standard sebagai bagian dari msbuild, Anda akan melihat kesalahan yang mirip dengan kesalahan : CA0055 : Tidak dapat mengidentifikasi platform untuk <your.dll>. Untuk menganalisis kode dalam proyek .NET Core atau .NET Standard, gunakan penganalisis kode sebagai gantinya.

Integrasi IDE (lingkungan pengembangan terintegrasi)

Anda dapat menjalankan analisis kode pada proyek Anda secara manual atau otomatis.

Untuk menjalankan analisis kode setiap kali Anda membuat proyek, pilih opsi di halaman properti Analisis Kode proyek. Untuk informasi selengkapnya, lihat Cara: Mengaktifkan dan Menonaktifkan Analisis Kode Otomatis.

Untuk menjalankan analisis kode secara manual pada proyek, dari bilah menu pilih Analisis>Jalankan Analisis Kode>Jalankan Analisis Kode pada <proyek>.

Seperangkat aturan

Aturan analisis kode untuk kode terkelola dikelompokkan ke dalam seperangkat aturan. Anda dapat menggunakan salah satu seperangkat aturan standar Microsoft, atau Anda dapat membuat seperangkat aturan kustom untuk memenuhi kebutuhan tertentu.

Menutupi peringatan

Sering kali, berguna untuk menunjukkan bahwa peringatan tidak berlaku. Ini memberi tahu pengembang, dan orang lain yang mungkin meninjau kode nanti, bahwa peringatan diselidiki dan kemudian ditekan atau diabaikan.

Penekanan peringatan dalam sumber diimplementasikan melalui atribut kustom. Untuk menekan peringatan, tambahkan atribut SuppressMessage ke kode sumber seperti yang ditunjukkan dalam contoh berikut:

[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1039:ListsAreStrongTyped")]
Public class MyClass
{
   // code
}

Untuk informasi selengkapnya, lihat Menyembunyikan peringatan.

Catatan

Jika Anda memigrasikan proyek ke Visual Studio 2019, Anda mungkin tiba-tiba dihadapkan dengan sejumlah besar peringatan analisis kode. Jika Anda belum siap untuk memperbaiki peringatan, Anda dapat menekan semuanya dengan memilih Analisis>Membangun dan Menekan Masalah Aktif.

Menjalankan analisis kode sebagai bagian dari kebijakan peninjauan

Sebagai organisasi, Anda mungkin ingin mewajibkan semua peninjauan memenuhi kebijakan tertentu. Secara khusus, Anda ingin memastikan bahwa Anda mengikuti kebijakan ini:

  • Tidak ada kesalahan build dalam kode yang sedang dicek masuk.

  • Analisis kode dijalankan sebagai bagian dari build terbaru.

Anda dapat menyelesaikan ini dengan menentukan kebijakan peninjauan. Untuk informasi selengkapnya, lihat Meningkatkan Kualitas Kode dengan Proyek Kebijakan Peninjauan.

Integrasi build tim

Anda dapat menggunakan fitur terintegrasi dari sistem build untuk menjalankan alat analisis sebagai bagian dari proses build. Untuk informasi selengkapnya, lihat Alur Azure.