Analisis kode

Anda dapat menggunakan penganalisis kode untuk menemukan potensi masalah dalam kode aplikasi .NET Framework Anda. Penganalisis menemukan potensi masalah dan menyarankan perbaikan untuk mereka.

Penganalisis kode berbasis Roslyn berjalan secara interaktif di Visual Studio saat Anda menulis kode atau sebagai bagian dari build CI. Anda harus menambahkan penganalisis ke proyek Anda sedini mungkin dalam siklus pengembangan. Semakin cepat Anda menemukan potensi masalah dalam kode Anda, semakin mudah untuk diperbaiki. Penganalisis menandai masalah dalam kode yang ada dan memperingatkan tentang masalah baru saat Anda melanjutkan pengembangan.

Nota

Artikel ini menggunakan paket NuGet Microsoft.NetFramework.Analyzers yang sekarang tidak digunakan lagi. Mulai dari .NET 5, penganalisis NET disertakan dengan .NET SDK. Jika diperlukan, Anda dapat menggunakan paket NuGet Microsoft.CodeAnalysis.NetAnalyzers sebagai gantinya. Untuk informasi selengkapnya, lihat Analisis kode di .NET.

Menginstal dan mengonfigurasi penganalisis

.NET Framework Analyzer dikirimkan dalam paket NuGet Microsoft.NetFramework.Analyzers . Paket ini menyediakan penganalisis yang khusus untuk .NET Framework API, yang mencakup penganalisis keamanan. Paket ini disertakan dengan paket Microsoft.CodeAnalysis.FxCopAnalyzers, jadi jika Anda menginstal paket tersebut, tidak perlu menginstal penganalisis .NET Framework secara terpisah.

Instal paket NuGet pada setiap proyek tempat Anda ingin penganalisis berjalan. Hanya satu pengembang yang perlu menambahkannya ke proyek. Paket penganalisis adalah dependensi proyek dan akan berjalan pada setiap komputer pengembang setelah memiliki solusi yang diperbarui.

Untuk menginstal paket, klik kanan pada proyek, dan pilih "Kelola Dependensi". Dari penjelajah NuGet, cari "Microsoft.NetFramework.Analyzers". Instal versi stabil terbaru di semua proyek dalam solusi Anda.

Gunakan penganalisis

Setelah paket NuGet diinstal, bangun solusi Anda. Penganalisis akan melaporkan masalah apa pun yang ditemukan di basis kode Anda. Masalah dilaporkan sebagai peringatan di jendela Daftar Kesalahan Visual Studio, seperti yang ditunjukkan pada gambar berikut:

Saat Anda menulis kode, Anda akan melihat garis bergelombang di bawah setiap masalah potensial pada kode Anda. Arahkan mouse ke atas masalah apa pun untuk mendapatkan informasi selengkapnya dan lihat saran untuk perbaikan yang mungkin, seperti yang ditunjukkan pada gambar berikut:

Untuk informasi selengkapnya, lihat Analisis kode di Visual Studio.

Tipe aturan

Penganalisis memeriksa kode dalam solusi Anda dan menghadirkan peringatan dengan awalan CA. Untuk daftar semua kemungkinan peringatan, lihat Aturan kualitas kode. Hanya beberapa peringatan ini yang berlaku untuk .NET Framework APIS, termasuk:

• CA1058: Jenis tidak boleh memperluas jenis dasar tertentu

• CA2153: Jangan menangkap pengecualian status yang rusak

• CA2229: Menerapkan konstruktor serialisasi

• CA2235: Tandai semua bidang yang tidak dapat dibuat serial

• CA2237: Menandai jenis ISerializable dengan SerializableAttribute

• CA3075: Pemrosesan DTD tidak aman di XML

• CA5350: Jangan gunakan algoritma kriptografi yang lemah

• CA5351 Jangan gunakan algoritma kriptografi yang rusak

Lihat juga

• Analisis kode di Visual Studio
• Analisis kode dalam .NET SDK